Skip to content
Ash

ash init

Create a new configuration file with sensible defaults.

Usage

Terminal window
uv run ash init [OPTIONS]

Options

OptionDescription
--path, -pCustom config file path (default: ~/.ash/config.toml)
--helpShow help message

Examples

Create default config file:

Terminal window
uv run ash init

Create config at custom path:

Terminal window
uv run ash init --path ~/my-ash-config.toml

Behavior

  • Creates ~/.ash/config.toml (or specified path)
  • Fails if config already exists (use --path for different location)
  • Generates a template with commented examples
  • After creation, add your API key and run ash upgrade

What’s Created

The generated config includes:

# API Keys - set these or use environment variables
[anthropic]
# api_key = "sk-ant-..."


[openai]
# api_key = "sk-..."


# Default model configuration
[models.default]
provider = "anthropic"
model = "claude-haiku-4-5"


# Optional: More capable model for complex tasks
# [models.sonnet]
# provider = "anthropic"
# model = "claude-sonnet-4-5"


# See docs for more configuration options

Next Steps

After running ash init:

  1. Edit ~/.ash/config.toml and add your API keys
  2. Run uv run ash upgrade to set up the database and sandbox
  3. Start chatting with uv run ash chat

See Also

  • setup - Interactive configuration wizard
  • config - View and validate configuration
  • upgrade - Run migrations and verify sandbox