CLI

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

Default

alphabase

Core 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

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 (default 127.0.0.1)
• --port (default random free port)
• --mdns
• --mdns-domain
• --cors
• --tls

Example Flows

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