From da6ca992aa149c5e10d488ebb363f098f5586b29 Mon Sep 17 00:00:00 2001
From: janet <vjanet@umich.edu>
Date: Mon, 20 Apr 2026 14:21:16 -0700
Subject: [PATCH] docs: clarify Claude Code setup, add macOS persistence and
 monitoring

- Claude Code plugin section now shows both steps: install plugin AND
  set ANTHROPIC_BASE_URL (plugin only auto-starts tamp, doesn't route)
- Add macOS launchd plist instructions (only systemd/Linux was documented)
- Document health endpoint for checking session stats and savings
- Fix tagline: "zero code changes" -> "one env var, no code changes"
---
 README.md | 25 +++++++++++++++++++++----
 1 file changed, 21 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index ec4cf47..d89b6d9 100644
--- a/README.md
+++ b/README.md
@@ -6,16 +6,17 @@
 npx @sliday/tamp
 ```
 
-### Claude Code plugin
-
-Auto-start on every session:
+### Claude Code
 
 ```bash
+# Install the plugin (auto-starts Tamp each session)
 claude plugin marketplace add sliday/claude-plugins
 claude plugin install tamp@sliday
+
+claude config set --user env.ANTHROPIC_BASE_URL http://localhost:7778 # route traffic through Tamp (one-time)
 ```
 
-Adds `/tamp:status` and `/tamp:config` commands.
+The plugin adds `/tamp:status` and `/tamp:config` commands.
 
 ### 🦞 OpenClaw
 
@@ -241,6 +242,22 @@ tamp install-service
 tamp status
 ```
 
+## Monitoring
+
+Check session stats any time via the health endpoint via browser or terminal:
+
+```bash
+curl -s 'http://localhost:7778/health?text' # Human-readable
+# Tamp v0.5.9 | 7 stages active | sidecar: n/a
+# Requests: 63 | Blocks: 2
+# Tokens saved: 1136 | Chars: 3482/61528 (5.7%)
+# Est. savings: $0.0034 (Sonnet $3/Mtok) | $0.0170 (Opus $15/Mtok)
+
+curl -s http://localhost:7778/health # JSON (for scripts/dashboards)
+```
+
+Inside Claude Code, run `/tamp:status`.
+
 ## Token Savings
 
 Claude Code sends full conversation history on every API call. Tool results accumulate — files, listings, outputs — all re-sent as input tokens.