Common snags.

I see no one-click Install button

You are probably on plain http://: a LAN IP or Tailscale 100.x address. The automatic Install prompt needs HTTPS or loopback/localhost; the browser rules are in Install as an App.

You can still pin manually:

• Chrome: menu → Save and share → Create shortcut → Open as window.
• iOS: Share → Add to Home Screen.

For the one-click prompt plus app badge, open the https://...ts.net URL from Remote Access.

I am not getting desktop notifications

kolu fires a native OS notification when an agent finishes in a terminal you are not actively watching. If you are looking at that terminal, the dock surfaces it instead and no banner fires. The multi-agent notification flow is part of Power Features.

Past that, check these in order:

1. Secure context. Notifications ride a service worker, which needs HTTPS or localhost; Remote Access gives kolu a private HTTPS URL.
2. Browser permission. Re-enable notifications from the address-bar lock icon if the browser prompt was dismissed.
3. OS permission. On macOS, the browser and the pinned app can have separate notification entries. Allow the right one and check Focus / Do Not Disturb.

Quick browser check:

navigator.serviceWorker
  .getRegistration()
  .then((r) => r?.showNotification("test"));

If that banner shows, the OS/browser layer is fine and the “not watching” rule above is the likely explanation.

Can I use it without Tailscale?

Yes. Locally over localhost, everything works, including one-click install, because loopback is a secure-context exemption. Tailscale matters when you want to reach kolu from another device and keep the install/badge/notification path; see Remote Access.

Which agents does kolu support?

Run any agent. The terminal is the interface, so aider, gemini, or whatever ships next week works the moment you run it.

Four agents get first-class state today: claude, codex, opencode, and grok (Grok Build). For these, kolu reads live agent state into the dock (thinking · tools · waiting · awaiting you — including Grok’s ask_user_question prompts). Claude, Codex, OpenCode, and Grok can also export the session as a self-contained HTML chat log or full transcript. Other agents still run in tiles; they just do not light up the dock.

For launching the first one, see First Five Minutes. For running many and exporting transcripts, see Power Features.

How do I update kolu?

Run the same command again:

nix --refresh run github:juspay/kolu

The --refresh flag busts Nix’s flake cache so you pull the latest commit; it is the same command from Quickstart.

I closed the welcome. How do I get it back?

Open the palette with Cmd/Ctrl + K and run Tutorial (alias: “Welcome”). It reopens the welcome overlay while you are working. The same palette opens the first terminal flow in First Five Minutes.

Still stuck?