pith-install

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.