CLI

Command-line entry points for AlphaBase.

The alphabase command starts the interactive TUI by default, and also exposes automation and server commands.

Default

alphabase

Command	Purpose
`alphabase`	Start TUI in current workspace
`alphabase run [message..]`	Run a prompt non-interactively
`alphabase serve`	Start headless runtime server
`alphabase web`	Start server and open browser UI
`alphabase attach <url>`	Attach TUI to a running server
`alphabase models [provider]`	List available models
`alphabase agent`	Manage agent definitions
`alphabase auth`	Manage provider credentials
`alphabase mcp`	Manage MCP server configuration
`alphabase session`	Session management operations
`alphabase export [sessionID]`	Export conversation data
`alphabase import <file-or-url>`	Import conversation data
`alphabase acp`	Start ACP server for compatible editors

Command	Purpose
`alphabase generate`	Generate the OpenAPI specification from the running server’s routes
`alphabase debug`	Debugging/troubleshooting tool group (`agent`, `config`, `file`, `harness-learning`, `lsp`, `ripgrep`, `scrap`, `skill`, `snapshot`)
`alphabase upgrade`	Upgrade AlphaBase to the latest or a specific version
`alphabase uninstall`	Uninstall AlphaBase and remove all related files
`alphabase runner`	Start a persistent prompt runner process (durable queue worker)
`alphabase stats`	Show token usage and cost statistics
`alphabase github`	Manage the GitHub agent integration
`alphabase pr <number>`	Fetch and check out a GitHub PR branch, then run AlphaBase
`alphabase login` (alias `signin`)	Sign in to your AlphaBase account (`--provider google\|github`)
`alphabase logout` (alias `signout`)	Sign out of your AlphaBase account
`alphabase whoami`	Show AlphaBase account sign-in status

Flag	Meaning
`--cwd`, `-C`	Set workspace directory for this command
`--add-dir`	Allow additional directories for file access
`--log-level`	`DEBUG`, `INFO`, `WARN`, `ERROR`
`--print-logs`	Print logs to stderr

These apply to serve and web:

Start local runtime server:

alphabase serve --hostname 127.0.0.1 --port 4096

Run one prompt and print JSON events:

alphabase run "summarize this repository" --format json

Use remote runtime from local terminal:

alphabase attach http://10.0.0.8:4096

Generate the OpenAPI spec from a running server:

alphabase generate > openapi.json