start here

From zero to running.

kolu is packaged with Nix. Install Nix with flakes enabled, then run one command. The same command runs kolu and updates it: --refresh busts Nix’s flake cache so you pull the current commit.

Install Nix if you do not already have it.

Use a Nix installer that enables flakes, such as the NixOS Asia guide.
Run kolu. It serves the app on 127.0.0.1:7681.
```
nix --refresh run github:juspay/kolu
```
Open the local URL.
```
http://127.0.0.1:7681
```

Kolu running in a browser workspace with the dock, a terminal tile, and the code panel visible. — The running workspace is the product: real xterm.js terminals on a canvas, with repo and agent state around them.

The Core Concepts page names the pieces you see here — canvas, tiles, dock rows, worktrees, and agent state — once the app is running.

Bind a different address

By default, kolu listens on loopback. To expose it on your LAN, pass a host and port after --:

nix --refresh run github:juspay/kolu -- --host 0.0.0.0 --port 8080

Open the address you chose. You should see an empty canvas. The empty canvas is the welcome state; it goes away when you create the first terminal and returns whenever there are none.

For another device, prefer the private HTTPS setup in Remote Access; plain LAN HTTP does not unlock install prompts, badges, or notifications.

Keep going

First five minutesopen a repo, name a worktree, and launch an agent Install as an apppin kolu as a PWA and unlock badges/notifications Reach it anywhereput kolu behind a private HTTPS URL with Tailscale Serve