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
fixedpolicy, 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 tokenworks. - 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>.