/pith-uninstall

name: pith-uninstall
description: >
  Uninstall Pith from Claude Code. Removes hooks, slash commands, and
  cleans pith entries from settings.json. Preserves ~/.pith/state.json
  (token history) unless user explicitly asks to wipe all data.

When to use

• User runs `/pith uninstall`
• User asks "remove pith", "uninstall pith", or "clean up pith"

---

Steps

1 — Confirm intent

Before running, ask once:

This will remove:
  • ~/.claude/hooks/pith/   (all hook scripts)
  • ~/.claude/commands/pith.md, budget.md, focus.md
  • pith entries in ~/.claude/settings.json

Your project wikis (wiki/) and token history (~/.pith/) are NOT deleted.

Proceed? (yes / no)

If user says no, stop. If yes, continue.

2 — Run the uninstall script

Locate the pith directory (same logic as pith-install step 1), then:

bash "<pith_dir>/uninstall.sh"

Stream the output so user sees each item removed.

3 — Verify clean

# Hooks gone
ls ~/.claude/hooks/pith/ 2>/dev/null && echo "STILL EXISTS" || echo "removed ok"

# Slash commands gone
ls ~/.claude/commands/ | grep -E "pith|budget|focus" 2>/dev/null && echo "STILL EXISTS" || echo "removed ok"

# Settings clean
node -e "const s=require(require('os').homedir()+'/.claude/settings.json'); const h=JSON.stringify(s.hooks||''); console.log(h.includes('pith')?'pith still in hooks':'hooks clean'); console.log(s.statusLine?'statusLine still set':'statusLine clean')"

4 — Optionally wipe all data

If the user said "remove everything" or "wipe all data", also run:

rm -rf ~/.pith
rm -f ~/.config/pith/config.json

Warn first: "This deletes your lifetime token savings history. Are you sure?"

5 — Confirm to user

Pith uninstalled.

Removed:
  ✓ hooks (session-start, post-tool-use, prompt-submit, stop)
  ✓ slash commands (/pith, /budget, /focus)
  ✓ settings.json entries

Preserved:
  • wiki/ directories in your projects
  • ~/.pith/state.json  (token history)

To reinstall: /pith install

---

Error handling

| Error | Fix | |-------|-----| | `uninstall.sh` not found | Run the node cleanup inline: remove `~/.claude/hooks/pith`, delete command files, patch settings manually | | `settings.json` malformed | Show the file, offer to remove pith keys manually | | Hook files already missing | Skip silently, still clean settings.json |

One-shot. Does not persist.