setuplisted
Install: claude install-skill Necmttn/ax
# ax:setup
Install and verify ax - the local agent-experience graph. After this skill
the user has the `ax` CLI on PATH, a running SurrealDB, the launchd watcher
reacting to new transcripts, and the ax skills loaded into Claude Code.
This skill is intentionally narrow: install + verify only. For day-to-day
use see `ax:retro` (experiment loop), `ax:extract-workflow` (reconstruct
the recipe behind a shipped artifact), or run the CLI directly.
## When to fire
Trigger phrases:
- "install ax" / "set up ax" / "first-time ax setup"
- "ax not found" / "where is axctl"
- "ax doctor" / "is ax running" / "is ax working"
- "what does ax give me"
Do NOT auto-trigger on unrelated work or when the user is already deep in
an ax workflow (`ax improve list`, `ax recall …`).
## Install
```bash
# 1. CLI binary (downloads the latest GitHub release; macOS-first,
# Linux works for ingest + CLI without launchd reactivity).
curl -fsSL https://raw.githubusercontent.com/Necmttn/ax/main/install.sh | bash
# 2. Skills - installs this skill + ax:retro + ax:extract-workflow
# into ~/.claude/skills/ (and ~/.agents/skills/ for codex).
npx skills add Necmttn/ax
# 3. First ingest - seeds the graph from the user's last 7 days of
# Claude Code + Codex transcripts.
PATH="$HOME/.local/bin:$PATH" ax ingest --since=7
```
If any step fails, run `ax doctor --json` and surface the blocker. If
`ax` itself isn't found after step 1, the user probably has a custom
shell rc - tell them to add `$HOME/.local