CLI Overview

Ash provides a comprehensive CLI for interacting with your assistant.

Usage

uv run ash [OPTIONS] COMMAND [ARGS]

Global Options

Option	Description
--help	Show help message
--version	Show version

Commands

Command	Description
init	Initialize configuration file
chat	Interactive chat or single prompt
serve	Start the server
config	Configuration management
memory	Memory management
sessions	Session management
schedule	Scheduled task management
skill	Skill management
sandbox	Sandbox management
db	Database operations
upgrade	Run migrations and checks
service	Service management

Getting Help

Get help for any command:

uv run ash --help
uv run ash chat --help
uv run ash memory --help

Environment Variables

Variable	Description
ASH_CONFIG	Config file path
ANTHROPIC_API_KEY	Anthropic API key
OPENAI_API_KEY	OpenAI API key
TELEGRAM_BOT_TOKEN	Telegram bot token
BRAVE_SEARCH_API_KEY	Brave Search API key
SENTRY_DSN	Sentry DSN

Quick Start

1. Initialize configuration:

   uv run ash init

2. Add your API keys to ~/.ash/config.toml

3. Run setup tasks:

   uv run ash upgrade

4. Start chatting:

   uv run ash chat

Running as a Service

For persistent operation with Telegram:

# Install as system service
uv run ash service install

# Start the service
uv run ash service start

# View logs
uv run ash service logs

See service for details.