CLI Overview

Ash CLI command surface (uv run ash --help):

Usage

uv run ash [OPTIONS] COMMAND [ARGS]...

Command	Description
`auth`	OAuth authentication
`chat`	Interactive chat or single prompt
`config`	Configuration management
`doctor`	Read-only operational checks
`graph`	Graph inspection utilities
`init`	Create starter configuration
`logs`	View/search logs
`memory`	Memory management
`people`	Person record management
`sandbox`	Sandbox management
`schedule`	Scheduled task management
`serve`	Start server
`service`	Background service management
`sessions`	Session inspection/debugging
`skill`	Skill management
`stats`	Operational stats
`upgrade`	Upgrade checks/build

Variable	Description
`ASH_HOME`	Base state directory (`config.toml`, logs, sessions, auth)
`OPENAI_API_KEY`	OpenAI API key
`ANTHROPIC_API_KEY`	Anthropic API key
`TELEGRAM_BOT_TOKEN`	Telegram bot token
`BRAVE_SEARCH_API_KEY`	Brave Search API key
`SENTRY_DSN`	Sentry DSN

uv run ash init
uv run ash auth login
uv run ash config validate
uv run ash upgrade
uv run ash chat

Need to remove Ash later? See Uninstall.