whetstone-cli 2.3.1

Installer and CLI for Claude Code token optimization (Headroom + RTK + Memory)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136

# Troubleshooting

## "headroom: command not found"

```bash
uv tool install "headroom-ai[proxy,code,mcp]"
# If installed but not on PATH:
python3 -m headroom proxy --port 8787
```

## "rtk: command not found"

```bash
# Install
curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh
# Add to PATH
export PATH="$HOME/.local/bin:$PATH"
# Persist
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc  # or ~/.bashrc
```

## "rtk gain" shows wrong output (Rust Type Kit conflict)

```bash
which rtk                 # Check which binary you have
# If it's the wrong one:
cargo uninstall rtk       # Remove Rust Type Kit
curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh
```

## RTK hook not rewriting commands

```bash
# Check settings.json has the RTK Claude hook
cat ~/.claude/settings.json | python3 -m json.tool
# Look for a command ending in: rtk hook claude

# Test the exact command from settings.json
# Example:
echo '{"tool_name":"Bash","tool_input":{"command":"git status"}}' | /home/you/.local/bin/rtk hook claude

# Reinstall whetstone's Claude hook configuration
# Choose a memory provider other than Skip so hook setup runs.
whetstone setup
```

## Headroom proxy not compressing

```bash
# Is proxy running?
curl -s localhost:8787/health

# Is env var set?
echo $ANTHROPIC_BASE_URL
# Should be: http://127.0.0.1:8787

# Start manually
headroom proxy --port 8787

# Check stats
curl -s localhost:8787/stats
```

## Skills not loading

```bash
# Are skills installed?
ls .claude/skills/

# Are rules present?
ls .claude/rules/

# Is the database initialized?
whetstone db stats

# Re-initialize DB
whetstone db init
```

## Hooks not firing at all

```bash
# Check global settings
cat ~/.claude/settings.json | python3 -m json.tool

# Check hook scripts exist and are accessible
ls -la ~/.claude/hooks/

# Restore from backup if settings.json is broken
ls ~/.claude/settings.json.bak.*
cp ~/.claude/settings.json.bak.NEWEST ~/.claude/settings.json
```

## Uninstall

```bash
whetstone uninstall
```

Interactive prompts let you choose which components to remove (whetstone binary, RTK, Headroom, project files).

### Manual removal

**Remove whetstone files (per-project):**
```bash
rm -rf .claude/skills .claude/rules .claude/commands .claude/db
rm -f config.local.json STACK-SETUP.md
```

**Remove RTK (global):**
```bash
rtk init -g --uninstall        # Remove hooks from settings.json
rm ~/.local/bin/rtk            # Remove binary
rm -rf ~/.local/share/rtk      # Remove tracking database
```

**Remove Headroom (global):**
```bash
uv tool uninstall headroom-ai
# Remove systemd service (if created)
systemctl --user disable --now headroom 2>/dev/null
rm -f ~/.config/systemd/user/headroom.service
```

**Restore original settings.json:**
```bash
ls -lt ~/.claude/settings.json.bak.* | head -5
cp ~/.claude/settings.json.bak.TIMESTAMP ~/.claude/settings.json
```

**Full cleanup:**
```bash
whetstone uninstall
rm -f ~/.local/bin/whetstone
rm -rf ~/.whetstone
```