Command-line tool

The codebahn binary is the same one you point AI assistants at. Run it without serve and it is a CLI for your pull requests, issues, and CI runs.

Install and log in

Install the binary as described in Connect an AI assistant, then log in:

codebahn auth login

This opens your browser for OAuth authorization. After you approve, the CLI saves your tokens to ~/.config/codebahn/config.json (it honors XDG_CONFIG_HOME). Tokens refresh automatically; you should not need to log in again unless you revoke access. Check the connection any time with codebahn auth status.

For CI or other headless environments, set CODEBAHN_URL and CODEBAHN_TOKEN as environment variables instead. Create a token under Settings > Applications in your Codebahn account.

Commands

Repository commands auto-detect the owner and repo from your git remote. Override with --owner/-o and --repo/-r, add --json for scriptable output, and --no-color to turn off colored output.

Command	Description
`auth login`	Authenticate via browser (OAuth)
`auth logout`	Clear saved tokens
`auth status`	Verify the connection
`pr list`	List pull requests
`pr view <n>`	Show a pull request
`pr create`	Open a pull request
`pr merge <n>`	Merge a pull request
`pr diff <n>`	Print a pull request’s diff
`issue list`	List issues
`issue view <n>`	Show an issue
`issue create`	Open an issue
`issue close <n>`	Close an issue
`issue comment <n>`	Comment on an issue
`run list`	List CI runs
`run view <id>`	Show a run
`run watch <id>`	Stream a run live
`run logs <id>`	Print build logs
`run dispatch <workflow>`	Trigger a workflow
`run cancel <id>`	Cancel a run
`search <query>`	Search code, repositories, and issues
`repo list`	List your repositories
`repo create <name>`	Create a new repository
`serve`	Start the MCP server

run watch streams progress over Server-Sent Events, so you can follow a build to completion without polling.

Next steps

Connect an AI assistant: the same binary, run as an MCP server.
Set up CI: the runs codebahn run reports on.
Run your own CI: BYO runner setup and external CI integration.