/pith-install

name: pith-install
description: >
  Install Pith into Claude Code. Copies hooks, patches settings.json,
  registers slash commands (/pith, /budget, /focus), and records the
  plugin root so hooks can resolve paths.

When to use

• User runs `/pith install`
• User asks "how do I install pith" or "set up pith"

---

Steps

1 — Locate the pith directory

Find where pith lives. Try in order: 1. `~/.claude/plugins/cache/pith/pith/*/` (installed via plugin marketplace) 2. The directory containing this SKILL.md file (cloned from GitHub) 3. Ask the user: "Where did you clone pith to?"

2 — Run the install script

bash "<pith_dir>/install.sh"

Stream the output to the user so they can see each step tick off.

3 — Verify success

After the script completes, confirm all five things installed:

# Hooks copied
ls ~/.claude/hooks/pith/

# Slash commands registered
ls ~/.claude/commands/ | grep -E "pith|budget|focus"

# Settings patched
node -e "const s=require(require('os').homedir()+'/.claude/settings.json'); console.log(JSON.stringify({hooks:Object.keys(s.hooks||{}), statusLine:!!s.statusLine},null,2))"

# Plugin root recorded
cat ~/.config/pith/config.json

# State dir exists
ls ~/.pith/

If any check fails, show the specific error and offer to re-run just that step.

4 — Confirm to user

Show this summary:

Pith installed.

Active automatically (zero config):
  ✓ Tool output compression
  ✓ Token meter in statusline  [PITH 0k/200k]
  ✓ Auto-compact at 70% context

On-demand:
  /pith lean|ultra|precise   output compression
  /pith debug|arch|plan      structured formats
  /pith commit               commit message
  /pith wiki                 project knowledge base
  /pith status               token usage
  /pith tour                 interactive walkthrough
  /budget <n>                hard token ceiling
  /focus <file>              load relevant sections only

Restart Claude Code to activate hooks.

---

Error handling

| Error | Fix | |-------|-----| | `node: command not found` | Tell user to install Node.js ≥18 | | `settings.json` parse error | Show the broken JSON, offer to reset to `{}` | | Permission denied on hooks dir | Run `mkdir -p ~/.claude/hooks/pith` first | | Plugin root not found | Ask user to re-clone: `git clone https://github.com/abhisekjha/pith` |

One-shot. Does not persist.