@change.codes/cli

The change command: work with repositories, Changes, Plans and coding agents on change.codes from a terminal, and expose the same tools to an agent over MCP.

Runs on Bun:

bun add --global @change.codes/cli
change auth login

change auth login opens the browser to sign in and stores a token for the profile; --url points a profile at a self-hosted instance. CHANGE_CODES_TOKEN in the environment is used instead of a stored token when set.

Commands

change auth login|logout|status [--url URL] [--profile NAME]
change setup [--agent codex,claude,cursor,grok,opencode | --all] [--global] [--dry-run]
change orgs list
change repos list [--org ORG]
change repo clone ORG/REPO [DIRECTORY]
change repo tree ORG/REPO [REV]
change repo cat ORG/REPO PATH [REV]
change plans list ORG/REPO
change plan show ORG/REPO NUMBER
change plan create ORG/REPO --title TITLE [--body BODY]
change plan update ORG/REPO NUMBER [--title TITLE] [--body BODY]
change plan push ORG/REPO FILE [--number NUMBER] [--title TITLE]
change plan history ORG/REPO NUMBER
change plan comment ORG/REPO NUMBER --body BODY
change plan request-approval ORG/REPO NUMBER --reviewer USERNAME
change plan approve ORG/REPO NUMBER
change plan delete ORG/REPO NUMBER --yes
change changes list ORG/REPO
change change show ORG/REPO NUMBER
change change create ORG/REPO --title TITLE [--body BODY] [--branch BRANCH] [--plan NUMBER] [--stack-on NUMBER]
change change stack ORG/REPO NUMBER --on NUMBER | --off
change change comment ORG/REPO NUMBER --body BODY
change change delete-branch ORG/REPO NUMBER
change change status ORG/REPO NUMBER --status idea|active|review|abandoned
change change review ORG/REPO NUMBER --revision N --approve|--request-changes
change change land ORG/REPO NUMBER --yes [--strategy merge|squash|rebase]
change mcp serve | tools | call TOOL [--args JSON]

Global options: --profile NAME, --json, --help, --version.

Agents

change setup writes the MCP configuration for the coding agents it finds (Codex, Claude Code, Cursor, Grok, OpenCode), or the ones named with --agent, so they can read code, open Changes and review through change.codes. change mcp serve is the local MCP server those configurations point at; change mcp tools lists what it offers and change mcp call invokes one tool directly.

Everything the command does is also available as a library through @change.codes/sdk and documented at change.codes/docs.