Skip to content

CLI

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

Default

Terminal window
alphabase

Core Commands

CommandPurpose
alphabaseStart TUI in current workspace
alphabase run [message..]Run a prompt non-interactively
alphabase serveStart headless runtime server
alphabase webStart server and open browser UI
alphabase attach <url>Attach TUI to a running server
alphabase models [provider]List available models
alphabase agentManage agent definitions
alphabase authManage provider credentials
alphabase mcpManage MCP server configuration
alphabase sessionSession management operations
alphabase export [sessionID]Export conversation data
alphabase import <file-or-url>Import conversation data
alphabase acpStart ACP server for compatible editors

Additional Commands

CommandPurpose
alphabase generateGenerate the OpenAPI specification from the running server’s routes
alphabase debugDebugging/troubleshooting tool group (agent, config, file, harness-learning, lsp, ripgrep, scrap, skill, snapshot)
alphabase upgradeUpgrade AlphaBase to the latest or a specific version
alphabase uninstallUninstall AlphaBase and remove all related files
alphabase runnerStart a persistent prompt runner process (durable queue worker)
alphabase statsShow token usage and cost statistics
alphabase githubManage 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 whoamiShow AlphaBase account sign-in status

Workspace And Diagnostics

CommandPurpose
alphabase sideOpen a workspace-linked side chat
alphabase doctorDiagnose runtime and workspace health
alphabase skillsDiscover and manage reusable skills
alphabase toolsInspect and manage agent tools
alphabase pluginManage runtime extensions
alphabase featureInspect server-advertised capabilities
alphabase completionGenerate 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

FlagMeaning
--cwd, -CSet workspace directory for this command
--add-dirAllow additional directories for file access
--log-levelDEBUG, INFO, WARN, ERROR
--print-logsPrint logs to stderr

Server/Web Flags

These apply to serve and web:

  • --hostname (default 127.0.0.1)
  • --port (default random free port)
  • --mdns
  • --mdns-domain
  • --cors
  • --tls

Run Flags

The most useful automation flags are:

  • --format default|json for formatted output or machine-readable event output
  • --continue, --session, and --fork for session continuation
  • --command for invoking a named command template
  • --model and --agent for explicit execution selection
  • --file for attaching files to a prompt
  • --title for naming a session
  • --attach and --dir for using an existing runtime
  • --thinking for controlling thinking-block display
  • --permissions safe|smart|full|interactive for the run policy
  • --workspace-delivery auto|required|none for 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:

Terminal window
alphabase serve --hostname 127.0.0.1 --port 4096

Run one prompt and print JSON events:

Terminal window
alphabase run "summarize this repository" --format json

Use remote runtime from local terminal:

Terminal window
alphabase attach https://runtime.example.com:4096

Only 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:

Terminal window
alphabase generate > openapi.json