Skip to content
Agent Kanban

Local edition · Configuration

Environment variables, the data directory and every setting.

This reference describes the standalone local edition started with pnpm start. For the hosted workspace, see Connect a runner.

Environment variables

Variable Default What it does
AK_HOME ~/.agent-kanban Data directory: SQLite database, worktrees, transcripts, the GitHub token file.
AK_PORT 4317 Port on 127.0.0.1.
AK_NO_OPEN unset 1 skips opening the browser.
AK_DEMO unset 1 seeds a sample repo and uses the fake executor and planner.
AK_DEMO_PACE 1 Slows demo runs down (for example 5) for recordings.
AK_REPOS_DIR ~/AgentKanban/repos Default parent folder for GitHub clones.
AK_LOG unset 1 turns on request logs (query strings are dropped).

Settings page

  • Runs and routing: concurrency (default 2), default policy, maximum escalations (default 2), the arm for the fixed policy, the planner arm, the acceptance-command timeout and the executor timeout.
  • OpenAI-compatible (harness): the harness path, base URL, the name of the environment variable that holds the API key (the key itself is never stored), steps and max tokens per reply.
  • Kiro: whether attempts pass --trust-all-tools. On by default; with it on, the agent can run any shell command on your machine, not only in its worktree.
  • GitHub: the OAuth app client id for the device flow. Not needed if gh auth token works.
  • Budgets and the rules table, described in Arms and budgets and Routing policies.

Custom CLIs

On the Agents page, add any coding-agent CLI without code: an id, the command, and an argument template with {prompt}, {model} and {effort}. The arguments run as an array, never through a shell. An unset placeholder drops its argument and the flag before it. Arms then use executor custom:<id>.