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 saves your instance URL and access token to ~/.config/codebahn/config.json (it honors XDG_CONFIG_HOME). Mint the token under your account settings; the scopes are listed in Create an access token. Check the connection any time with codebahn auth status.

To skip the config file, set CODEBAHN_URL and CODEBAHN_TOKEN as environment variables instead. That is how CI authenticates.

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`	Save your token to the config file
`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.