Skip to content
Agent Kanban

Connect a runner

Go from a private workspace to a verified diff on your machine.

Take the starter task

Open Try a starter repo and continue with GitHub. GitHub identifies the owner of the private board. The runner uses the coding agent signed in on your computer.

Select Get setup command (or Try a starter repo on an empty board). Copy the whole line into a terminal on macOS or Linux with Git, npm and Node.js 22.13 or newer. It installs the runner and pairs this machine using a ten-minute code. Keep that terminal open while work runs.

The runner creates a local starter shop. The board opens a task that asks for a price formatter. Its acceptance command checks that 405 cents returns 4.05 and zero returns 0.00. Select your signed-in provider and run the task. The board opens the verified patch when it is ready.

Use your own repository

Choose Use my repo. Run the copied command inside the root of a Git repository with at least one commit. Enter a request and the shell command that should pass. The runner creates an isolated worktree for the task.

The install portion of either setup command is:

npm install -g https://agent-kanban.aryangosain.com/agent-kanban-runner.tgz

If a provider needs authentication, use its local sign-in command in another terminal. See compatible coding agents for built-in adapters and custom CLIs. The runner checks provider status every minute. Set AK_CODEX_MODEL or AK_CLAUDE_MODEL when starting the runner to choose a model available to that account.

Review the result

Read the diff beside Verification output. Accept and merge locally applies the reviewed commit to the repository’s base branch. Request revision records your feedback and starts from the prior change. For a repository with a GitHub origin, Open pull request uses separate local GitHub credentials.

Return to work

agent-kanban start
agent-kanban add /absolute/path/to/repo

Use Ctrl-C or run agent-kanban disconnect in another terminal to pause. A disconnected runner can reconnect to the same workspace. An interrupted run preserves its worktree and needs an explicit retry. A failed check shows its output under Needs input. To end the pairing, use Machines → Connected machines → Revoke machine access or agent-kanban revoke. A new pairing starts with a fresh list of local repositories.