@gethmy/mcp 3.2.0 → 3.4.0

package/README.md

@@ -5,7 +5,7 @@ Claude Code, OpenAI Codex, Cursor, and any MCP client claim cards, report progre
 
 ## Features
 
-- **77 MCP Tools** for full board control, knowledge graph, and workflow plans
+- **79 MCP Tools** for full board control, knowledge graph, and workflow plans
 - **Global Skills** — installable in one command, served from the DB-backed [skill hub](../../docs/skills.md) with auto-update and admin-managed versioning
 - **Knowledge Graph Memory** — Phase 1 surface: hybrid retrieval (vector + lexical + RRF), session-scoped working memory, activity feed. See [docs/memory.md](../../docs/memory.md)
 - **GSD Workflow Plans** - plan/execute/verify/done lifecycle with auto card creation
@@ -89,7 +89,7 @@ If you prefer to configure manually (e.g., in Claude.ai's UI):
 1. Get an API key from [Harmony](https://gethmy.com/user/keys)
 2. In Claude.ai, add a remote MCP server with URL `https://mcp.gethmy.com/mcp`
 3. Set the Authorization header to `Bearer hmy_your_key_here`
-4. All 77 Harmony tools become available in your conversation
+4. All 79 Harmony tools become available in your conversation
 
 **Session management** is automatic - sessions have a 1-hour TTL and are created/renewed transparently.
 
@@ -122,8 +122,47 @@ npx @gethmy/mcp reset              # Clear all configuration
 
 # Server (called by agents automatically)
 npx @gethmy/mcp serve              # Start MCP server
+
+# Run timeline hook (opt-in) — see below
+npx @gethmy/mcp hook install       # Stream this session's tool calls to the card
+npx @gethmy/mcp hook status        # Is it installed? Which sessions are live?
+npx @gethmy/mcp hook uninstall     # Remove it
+```
+
+### Run Timeline Hook
+
+By default a card's run timeline shows only what the MCP tools report: the
+session starting, each progress checkpoint, the session ending. Your editor's
+own `Read`, `Edit`, `Bash` and `Grep` calls never reach the MCP server, so they
+cannot appear there.
+
+`hook install` closes that gap. It adds one `PostToolUse` entry to
+`~/.claude/settings.json`, and from then on the tool calls of a session that
+holds a card stream to that card's timeline with their input and output, live —
+the same view a Harmony agent daemon run gets, without you reporting anything.
+
+```bash
+npx @gethmy/mcp hook install
 ```
 
+Four things worth knowing:
+
+- **It writes only the user layer.** `~/.claude/settings.json`, never a
+  project's `.claude/settings.json`. A project-layer `hooks` key would break
+  contained agent runs in that repo, and the user layer is also what keeps a
+  daemon run from reporting its stream twice.
+- **Re-run it after upgrading.** The entry pins the exact install that wrote
+  it, and an upgrade or a cleared `npx`/`bunx` cache moves that path. The
+  command guards its own paths, so nothing breaks in the meantime — the hook
+  just goes quiet, and `hook status` says so.
+- **Tool inputs and outputs are redacted before they leave your machine.**
+  Credential paths, tokens, and the usual secret-shaped values are withheld;
+  large payloads are truncated. The full rule is in
+  [`docs/agent-run-events.md`](https://github.com/Way/getharmony/blob/main/docs/agent-run-events.md).
+- **It is off unless you install it, and `HARMONY_DISABLE_RUN_HOOK=1` turns the
+  stream off without uninstalling** — for when a team decides tool inputs do
+  not belong on a shared board.
+
 ### Setup Options
 
 | Flag                       | Description                                          |