CLI
The alphabase command starts the interactive TUI by default, and also exposes automation and server commands.
Default
alphabaseCore Commands
| 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 |
Additional Commands
| 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 |
Workspace And Diagnostics
| Command | Purpose |
|---|---|
alphabase side | Open a workspace-linked side chat |
alphabase doctor | Diagnose runtime and workspace health |
alphabase skills | Discover and manage reusable skills |
alphabase tools | Inspect and manage agent tools |
alphabase plugin | Manage runtime extensions |
alphabase feature | Inspect server-advertised capabilities |
alphabase completion | Generate shell completion |
Some deployments also expose account, team, workspace, memory, venture, CIS, showcase, and execution-control command families. Their availability and behavior are deployment-dependent; do not automate against them without a versioned deployment contract.
Global Flags
| 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 |
Server/Web Flags
These apply to serve and web:
--hostname(default127.0.0.1)--port(default random free port)--mdns--mdns-domain--cors--tls
Run Flags
The most useful automation flags are:
--format default|jsonfor formatted output or machine-readable event output--continue,--session, and--forkfor session continuation--commandfor invoking a named command template--modeland--agentfor explicit execution selection--filefor attaching files to a prompt--titlefor naming a session--attachand--dirfor using an existing runtime--thinkingfor controlling thinking-block display--permissions safe|smart|full|interactivefor the run policy--workspace-delivery auto|required|nonefor artifact delivery behavior
Routing and council options are advanced, deployment-dependent features. Treat their request fields as versioned API options rather than stable global settings.
Example Flows
Start local runtime server:
alphabase serve --hostname 127.0.0.1 --port 4096Run one prompt and print JSON events:
alphabase run "summarize this repository" --format jsonUse remote runtime from local terminal:
alphabase attach https://runtime.example.com:4096Only attach to a runtime you control over an authenticated, encrypted, and network-restricted connection. Do not place credentials or untrusted runtime URLs in scripts or shared command history.
Generate the OpenAPI spec from a running server:
alphabase generate > openapi.json