tengolabs/killbottleneck

English | Čeština
Website ·
Documentation ·
Changelog ·
Licence
> 🧪 **Public beta.** killBottleneck is feature-complete and in beta — the cloud
> and the self-hosted version alike; it is one and the same app. What we are
> testing here is the **self-hosted** side: installation, reverse proxies, your
> own SMTP, upgrades. Install it (Quick start below), try to break it, and
> tell us what happened: bugs → Issues, ideas → Discussions.
> v1.0 ships when the beta goes quiet.
A visual picture of your projects, your company and its processes — goal maps that people and AI agents work on together, **entirely on your own server: your data never leaves the company**. Open in the spirit of open source, just without the right to resell it as a hosted service — see License.
**Nothing here phones home.** On a default install the server sends no request anywhere, and
the app loads nothing from a third-party CDN — fonts included, they are served from your own
instance. Everything that could leave your network is something **you** switch on:
| Outbound request | When it happens | Turn it off |
| --- | --- | --- |
| GitHub Releases API | Version check, from the **user's browser** — not the server | KB_UPDATE_CHECK=0 |
| The AI endpoint you configured | Only with KB_AI_PROVIDER ≠ none; your own Ollama or any endpoint you choose | KB_AI_PROVIDER=none (default) |
| Google (sign-in, Drive picker) | Only when you configure KB_GOOGLE_* | leave those empty (default) |
There is no telemetry, no analytics and no licence check.
Contents — this README is the full reference; the short version is on the website .
- Quick start
- What it does without AI · On a phone
- AI features (optional)
- AI assistant over MCP
- Who performs a step: a person, or an automation — includes the **webhook contract** for your own agents
- Moving a project elsewhere (JSON export/import)
- Appearance (skins) · Notifications · Time zone and recurring templates
- Data and backup · Team · Registration and the registration key
- Sign in with Google · Attachments · E-mail (SMTP)
- HTTPS (access from outside) · Updating
- License — fair-code · Contact
Quick start
All you need is Docker. Then:
killBottleneck runs at http://SERVER-IP:8090. Colleagues on the local network just open it in a browser.
**The first user to register automatically becomes the administrator.** Everyone else can
register themselves, or the administrator invites them from Administration (this creates an
account with a temporary password to hand over).
What it does without AI
A full goal map editor (nodes, edges, statuses, notes), multiple maps per user, comments on
goals, sharing maps with colleagues (read / edit), public maps, export to image/PDF.
**The “My day” panel** (both the home page and the Tasks page): a clickable overview of
overdue / today / within a week / blocking others, computed live from your data; name days
next to the date; a portrait PNG export for mobile — both full (with task names) and
**anonymous** (names redacted, for social media). Over HTTPS you also get **Share…**
(your phone's native Web Share dialog, no third-party service involved).
**Time tracking**: a ⏱ timer in the top bar (one click starts an “empty” measurement — the
project/client/goal is assigned while it runs or afterwards), a timer on every task and every
goal in a map (measuring **never changes a status** — it is purely supplementary), a left-hand
“Time tracking” panel with the records (from–to, retroactive assignment), a “Time worked”
dialog in the user menu (today/this week, broken down by project and client), a **client**
registry (project→client, so time adds up per client too), and auto-stop for forgotten timers
after 12 h. **Inbox behaviour:** an unassigned measurement stopped with a note (e.g. “call with
the client”) also saves itself as an idea in your stash.
On a phone
The same instance, opened on a phone, switches to a **simplified view**: today's tasks,
tick them off, add one, and read messages — no map canvas to fight with on a small screen.
You can switch back to the full view at any time, and the app can be added to the home
screen (over HTTPS) so it behaves like a native one.
More in the Simplified view guide.
AI features (optional)
**The assistant** lives in a side panel next to your maps. It plans your day with you (morning
briefing, evening planning), sorts notes from a photo, a PDF or a **voice note**, drafts a whole
project after a few questions, prepares a meeting, reviews your week and, for managers, runs a