CLI

Run OpenABCode from scripts, one-shot prompts, or terminal sessions.

TUI command

Run openabcode with no command to start the TUI for the current directory. Pass a path to open another project.

openabcode
openabcode /path/to/project

Run command

Use openabcode run for non-interactive prompts, scripts, and CI jobs. It uses the same routed runtime as the TUI.

openabcode run "explain this package"
openabcode run --format json "summarize failing tests"

Auth commands

Use auth commands to configure BYOK provider credentials. Credentials are stored outside your repository.

openabcode auth login
openabcode auth list
openabcode auth logout

Models command

Use models to list exact provider/model IDs. Pass a provider ID to filter the list.

openabcode models
openabcode models anthropic
openabcode models openabcode

Model flag

Use -m or --model with provider/model to force one model for a command. Without this flag, OpenABCode routes automatically.

openabcode run -m openabcode/gpt-5.4 "debug this failure"
openabcode run -m google/gemini-3.5-flash "inspect this GCP module"

Server and web

Use serve for a headless API server and web for a browser interface. Both use OpenABCode routing by default.

openabcode serve --port 4096
openabcode web --port 4096

Session tools

Use session, stats, export, and import commands to inspect or move session data.

openabcode session list
openabcode stats --models
openabcode export --sanitize

Extension commands

OpenABCode keeps opencode-compatible extension commands for MCP servers, agents, plugins, custom commands, and Git automation.

openabcode mcp list
openabcode agent list
openabcode plug <module>
openabcode github install

Runtime control

OpenABCode routing is on by default. Disable it only when you need to compare against legacy opencode model resolution.

OPENABCODE_RUNTIME=0 openabcode
openabcode serve --no-openabcode-runtime

Environment variables

Environment variables are for credentials, server behavior, and automation. They are not required to choose a model.

  • Use openabcode auth login for interactive credentials.
  • Use OPENCODE_CONFIG for an explicit config path.
  • Use OPENABCODE_API_KEY for hosted mode.