Documentation
The full map of the documentation is on the left. Here is the shortest path to what you are most likely looking for.
I use the app (cloud or self-hosted)
Start with Your first map — from an empty account to a working map with tasks in ten minutes:
| I want to… | Go to |
|---|---|
| know what to do today | My day and the daily focus |
| use it on my phone | On your phone |
| change the look, or build my own | Your own skin |
| have the AI draft a map for me | New project with AI |
| talk my projects through with AI, read a photo of notes, set a deadline | The AI assistant on the side |
| know what the trial includes and what comes after | The trial and plans |
| log in to my instance / find its address | Where do I log in |
| set up my team: invites, roles, AI | Team setup (admin) |
| connect a spreadsheet or an automation tool | Google Sheets · n8n |
| connect my own code or an AI assistant | REST API · MCP server — works in the cloud too |
| have killBottleneck on Windows with notifications | Windows app |
| run the cloud on my own domain | Custom domain |
| a quick answer when something doesn't work | FAQ |
| know what a word in the app means | Glossary |
Features one by one
Every feature has its own illustrated page — the same Features section as in the left menu:
| Area | Pages |
|---|---|
| The map | The map and goals · Bottlenecks · Arranging · Sorting sub-goals · Readability · Goal settings · The canvas · Collaboration and conflicts |
| My work | Tasks and My day · Calendar · My map · Daily focus ★ · The simplified view (phone) · The idea stash · Time tracking |
| Projects and overviews | Templates · Dashboard and changes · Organization · Export and import · Public maps · Invoices · Archive |
| Automation | Rules · Deputies and dynamic targets · AI agents |
| The team | Team and roles · Organization settings · Org structure · External contacts · Notifications · Skins · Bug reports and ideas · Account and settings · Glossary |
I install and run it myself
| I want to… | Go to |
|---|---|
| understand what the app actually does | What killBottleneck is |
| get it running in two commands | Quick start |
| install it properly on a server | Installation |
| change ports, AI, sign-in, limits | Configuration · Environment variables |
| put it behind a domain with HTTPS | HTTPS and a reverse proxy |
| be sure I can restore my data | Backup and restore |
| update to a new version | Updating |
| drive it from my own code | REST API |
| let an AI assistant work with my maps | MCP server |
| plug in my own AI service | Custom AI endpoint |
| understand the API error replies | Error codes |
| know what I may do with the code | License — MIT |
| know who is behind it | About the project |
What this documentation covers
The Tutorials and Features sections apply to every deployment — the cloud and your own server run the same application. The Guide and Reference sections document the free self-hosted product: how to install it, configure it, back it up, and how to talk to it from your own code or from an AI assistant. The documentation is written against the version in the repository, and the API reference is derived from the routes the server actually registers.
Something not working, or can't find where a thing is? Start with the FAQ.
Language
The application interface is available in English and Czech. This documentation exists in both as well — the Čeština link top right leads to the Czech site (the pages have different addresses, so the switch always opens its home page). The API and the MCP layer are English-only by design, so that integrators and AI assistants always get the same wording.


