kolu
Docs

this machine

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.

  1. Install Nix if you do not already have it.

    Use a Nix installer that enables flakes, such as the NixOS Asia guide.

  2. Run kolu. It serves the app on 127.0.0.1:7681.

    nix --refresh run github:juspay/kolu -- web
  3. 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 terminals on a canvas, with repo and agent state around them.

The empty canvas is the welcome state — a short list of next moments (choose your coding agents, pin the app, reach it over HTTPS). It goes away when you create the first terminal and returns whenever there are none.

Its first question is which AI coding agents kolu should bring into your terminals — kept up to date, nothing to install. Enter turns them on as they ship; a profile is an Agent Plugin in a repository, and Juspay’s is one click away to add first. Not now leaves you plain terminals and asks again later, and Settings → Agents changes it at any time. Until agents are on, the welcome card keeps the choice at the top.

First run compiling? Enable the binary cache

If the first run starts compiling instead of downloading, enable the binary cache. To listen on a different address, see Deployment. The command that starts the app is kolu web; a bare kolu lists subcommands — Terminal UI for the shell, MCP for a coding agent.

Next