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)

Behavior

  • Creates config file at ~/.ash/config.toml (or custom --path)
  • Fails if the target file already exists
  • Creates workspace defaults under ~/.ash/workspace
  • Prints next step: run ash upgrade after adding auth/config

Examples

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

Next Steps

  1. Configure model provider entries in config (openai-oauth recommended)
  2. Run uv run ash auth login for OAuth provider setup
  3. Run uv run ash config validate
  4. Run uv run ash upgrade