Skip to content
Ash

ash upgrade

Run all necessary setup and upgrade tasks.

Usage

Terminal window
uv run ash upgrade

What It Does

  1. Migrates schedule data into graph storage - Imports legacy ~/.ash/schedule.jsonl entries into ~/.ash/graph/schedules.jsonl, writes schedule edges, and removes the legacy file
  2. Verifies sandbox - Checks sandbox image is built and working

When to Run

Run after:

  • Installing Ash
  • Updating to a new version
  • Changing configuration

Examples

After installation:

Terminal window
uv run ash upgrade

After updating:

Terminal window
git pull
uv sync
uv run ash upgrade

Output

Running database migrations...
✓ Database up to date
Verifying sandbox...
✓ Sandbox ready

Troubleshooting

If migrations fail, check:

Terminal window
uv run ash db status

If sandbox verification fails, rebuild:

Terminal window
uv run ash sandbox build
uv run ash sandbox status