skill_recovery.md
<!-- craft-anything skill reference -->
# Connection and recovery
| Symptom | What to do |
|---|---|
| No `craft-anything` tools in the app | `craft-anything-cli doctor`; if the registration is missing or stale, `craft-anything-cli setup --client <id> --dry-run`, show the plan, then apply with `--yes` after the user agrees |
| Registration looks right but no tools | Restart or reconnect the app; it reads its config at start-up |
| `craft-anything-cli` not found from a shell | The program isn't on `PATH`; registrations use its absolute path, so the app may still work |
| The app asks to approve each tool | That's the app's own policy; don't change it without the user |
| A tool says an engine is missing | Follow its remediation (Settings → Engines in the desktop app) |
Setup only ever adds or updates the `craft-anything` entry. It keeps comments and every other server,
writes a `.craft-anything.backup` copy of the original file first (never overwriting an older backup),
and puts the original back if the result doesn't read back correctly. `craft-anything-cli uninstall`
removes only entries and skill files that Craft Anything itself created.
Command-line fallback when no app is connected: every tool is a subcommand, for example
`craft-anything-cli triage /path/to/program` or
`craft-anything-cli core-target-open --json '{"path": "/path/to/program"}'`.
No file is open. Choose one in the tree, or press Ctrl+O (⌘O on a Mac) to find one by name.
Syntax highlighting could not load. The unmodified read-only text remains available above.