Skip to content
Ash

Uninstall

This guide covers a full cleanup of Ash.

What This Removes

  • Ash background service registration (if installed)
  • Running Ash service processes
  • Sandbox containers and optional sandbox image
  • Ash state directory: ASH_HOME (or ~/.ash by default)
  • Optional source checkout and environment
  • Optional package-managed CLI install

Resolve Your Ash Home Path

Ash stores state under:

  • $ASH_HOME if set
  • Otherwise ~/.ash

Check the exact directory before deletion:

Terminal window
echo "${ASH_HOME:-$HOME/.ash}"

Full Uninstall Steps

  1. Stop Ash service/processes

    Terminal window
    uv run ash service stop
    uv run ash service status

  2. Uninstall auto-start service registration

    Terminal window
    uv run ash service uninstall

  3. Clean sandbox artifacts

    Terminal window
    uv run ash sandbox clean --force

  4. Remove Ash state directory (guarded)

    Terminal window
    TARGET="${ASH_HOME:-$HOME/.ash}"
    test -d "$TARGET" && printf 'Removing %s\n' "$TARGET"
    rm -rf -- "$TARGET"

Optional: Remove Source Checkout + Virtual Environment

If you installed from source and no longer want the checkout:

Terminal window
# Example only: replace with your actual checkout path
REPO_DIR="$HOME/src/ash"
test -d "$REPO_DIR" && printf 'Removing %s\n' "$REPO_DIR"
rm -rf -- "$REPO_DIR"

Optional: Remove Package-Managed Install

If you installed ash as a tool or package (instead of source checkout), remove it with the same tool you used to install:

Terminal window
# uv tool flow
uv tool uninstall ash


# pip/pipx flow
pip uninstall ash
pipx uninstall ash

Verify Cleanup

Run these checks:

Terminal window
uv run ash service status
uv run ash sandbox status
test -d "${ASH_HOME:-$HOME/.ash}" || echo "Ash state removed"

Expected outcomes:

  • Service is stopped/uninstalled
  • Sandbox containers/image are removed (or not present)
  • Ash state directory no longer exists