@honcho-ai/claude-honcho 0.3.1 → 0.3.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. package/.claude-plugin/plugin.json +1 -1
  2. package/README.md +95 -12
  3. package/dist/hooks/post-tool-use.js +16714 -29
  4. package/dist/hooks/post-tool-use.js.map +91 -5
  5. package/dist/hooks/pre-compact.js +16909 -39
  6. package/dist/hooks/pre-compact.js.map +92 -6
  7. package/dist/hooks/pre-tool-honcho.js +829 -10
  8. package/dist/hooks/pre-tool-honcho.js.map +10 -5
  9. package/dist/hooks/save-user-message.js +16552 -32
  10. package/dist/hooks/save-user-message.js.map +90 -5
  11. package/dist/hooks/session-end.js +1003 -20
  12. package/dist/hooks/session-end.js.map +12 -5
  13. package/dist/hooks/session-start.js +16961 -51
  14. package/dist/hooks/session-start.js.map +93 -5
  15. package/dist/hooks/stop.js +16681 -33
  16. package/dist/hooks/stop.js.map +90 -5
  17. package/dist/hooks/user-prompt.js +17004 -14
  18. package/dist/hooks/user-prompt.js.map +93 -4
  19. package/dist/mcp-server.js +17097 -907
  20. package/dist/mcp-server.js.map +88 -4
  21. package/dist/skills/backfill-runner.js +16309 -69
  22. package/dist/skills/backfill-runner.js.map +89 -4
  23. package/dist/skills/setup-runner.js +16185 -60
  24. package/dist/skills/setup-runner.js.map +88 -5
  25. package/dist/skills/status-runner.js +16184 -21
  26. package/dist/skills/status-runner.js.map +88 -4
  27. package/package.json +1 -1
  28. package/dist/chunk-084dpgp3.js +0 -556
  29. package/dist/chunk-084dpgp3.js.map +0 -10
  30. package/dist/chunk-49wja30f.js +0 -20
  31. package/dist/chunk-49wja30f.js.map +0 -10
  32. package/dist/chunk-4ryv9310.js +0 -15534
  33. package/dist/chunk-4ryv9310.js.map +0 -87
  34. package/dist/chunk-4zgbdwm4.js +0 -261
  35. package/dist/chunk-4zgbdwm4.js.map +0 -10
  36. package/dist/chunk-6yybt92z.js +0 -106
  37. package/dist/chunk-6yybt92z.js.map +0 -9
  38. package/dist/chunk-9pntsn3x.js +0 -35
  39. package/dist/chunk-9pntsn3x.js.map +0 -10
  40. package/dist/chunk-d2gc13m0.js +0 -161
  41. package/dist/chunk-d2gc13m0.js.map +0 -11
  42. package/dist/chunk-dxbm7kmf.js +0 -331
  43. package/dist/chunk-dxbm7kmf.js.map +0 -10
  44. package/dist/chunk-gnp95nzg.js +0 -438
  45. package/dist/chunk-gnp95nzg.js.map +0 -12
  46. package/dist/chunk-jgtvcc65.js +0 -90
  47. package/dist/chunk-jgtvcc65.js.map +0 -10
  48. package/dist/chunk-jr0fd6n2.js +0 -181
  49. package/dist/chunk-jr0fd6n2.js.map +0 -11
  50. package/dist/chunk-wm6hvkcv.js +0 -245
  51. package/dist/chunk-wm6hvkcv.js.map +0 -10
  52. package/dist/chunk-xdntcesh.js +0 -15450
  53. package/dist/chunk-xdntcesh.js.map +0 -86
  54. package/dist/chunk-xtdvbfxw.js +0 -146
  55. package/dist/chunk-xtdvbfxw.js.map +0 -10
  56. package/dist/chunk-yfrrc1d5.js +0 -838
  57. package/dist/chunk-yfrrc1d5.js.map +0 -12
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "honcho",
3
- "version": "0.3.1",
3
+ "version": "0.3.3",
4
4
  "description": "Persistent memory for Claude Code sessions using Honcho by Plastic Labs",
5
5
  "author": {
6
6
  "name": "Plastic Labs",
package/README.md CHANGED
@@ -44,9 +44,10 @@ Give Claude Code long-term memory that survives context wipes, session restarts,
44
44
 
45
45
  ## Prerequisites
46
46
 
47
- A Honcho API key from [app.honcho.dev](https://app.honcho.dev). Nothing else --
48
- the plugin ships as a self-contained bundle and runs on the Node runtime Claude
49
- Code already provides.
47
+ - A Honcho API key from [app.honcho.dev](https://app.honcho.dev)
48
+ - [Node.js](https://nodejs.org) on your PATH
49
+
50
+ The plugin ships as a self-contained bundle -- no other dependencies needed.
50
51
 
51
52
  ## Quick Start
52
53
 
@@ -120,7 +121,7 @@ to the peer name you chose in your environment: it will carry across different p
120
121
  - **Git Awareness** — Detects branch switches, commits, and changes made outside Claude
121
122
  - **Flexible Sessions** — Map sessions per directory, per git branch, or per chat instance
122
123
  - **AI Self-Awareness** — Claude knows what it was working on, even after restarts
123
- - **Cross-Tool Context** — Link workspaces across Claude Code, Cursor, and other hosts so context flows between tools
124
+ - **Configurable Memory Injection** — Choose exactly what context is injected at session start and per turn
124
125
  - **Team Support** — Multiple people can share a workspace and build context together
125
126
  - **MCP Tools** — Search memory, query knowledge about you, and save insights
126
127
 
@@ -128,13 +129,20 @@ to the peer name you chose in your environment: it will carry across different p
128
129
 
129
130
  The honcho plugin provides these tools via MCP:
130
131
 
131
- | Tool | Description |
132
- | ------------------- | ------------------------------------------------ |
133
- | `search` | Semantic search across session messages |
134
- | `chat` | Query Honcho's knowledge about the user |
135
- | `create_conclusion` | Save insights about the user to memory |
136
- | `get_config` | View current configuration and status |
137
- | `set_config` | Change any configuration field programmatically |
132
+ | Tool | Description |
133
+ | -------------------- | -------------------------------------------------------------- |
134
+ | `search` | Semantic search across session messages and saved conclusions |
135
+ | `chat` | Query Honcho's knowledge about the user (dialectic reasoning) |
136
+ | `create_conclusion` | Save insights about the user to memory |
137
+ | `list_conclusions` | List saved conclusions |
138
+ | `query_conclusions` | Semantic search over saved conclusions |
139
+ | `delete_conclusion` | Delete a conclusion by ID |
140
+ | `get_briefing` | Load the session briefing: session summary + peer card |
141
+ | `get_context` | Retrieve the full context object (representation + peer card) |
142
+ | `get_representation` | Retrieve the user's representation string |
143
+ | `get_config` | View current configuration and status |
144
+ | `set_config` | Change any configuration field programmatically |
145
+ | `honcho_remember` | Fan-out dialectic recall (only registered when `rememberTool: true`) |
138
146
 
139
147
  ## Skills
140
148
 
@@ -144,6 +152,7 @@ The honcho plugin provides these tools via MCP:
144
152
  | `/honcho:config` | Interactive configuration menu |
145
153
  | `/honcho:setup` | First-time setup — validate API key and create config |
146
154
  | `/honcho:interview` | Interview to capture stable, cross-project user preferences |
155
+ | `/honcho:briefing` | Load the session briefing via a visible tool call |
147
156
  | `/honcho:import` | Backfill past Claude Code sessions into Honcho memory |
148
157
  | `/honcho:insights` | Distill memory into CLAUDE.md edits, style rules, skill ideas |
149
158
 
@@ -181,6 +190,8 @@ All configuration lives in a single global file at `~/.honcho/config.json`. You
181
190
 
182
191
  // Message handling
183
192
  "saveMessages": true,
193
+ "saveToolUse": false, // Save [Tool] action summaries (default: false)
194
+ "saveGitEvents": false, // Save [Git External] state-change events (default: false)
184
195
  "messageUpload": {
185
196
  "maxUserTokens": null, // Truncate user messages (null = no limit)
186
197
  "maxAssistantTokens": null, // Truncate assistant messages (null = no limit)
@@ -193,6 +204,16 @@ All configuration lives in a single global file at `~/.honcho/config.json`. You
193
204
  "ttlSeconds": 300, // Cache TTL for context
194
205
  "skipDialectic": false // Skip dialectic chat() calls in user-prompt hook
195
206
  },
207
+ "reasoningLevel": "medium", // Default dialectic reasoning tier: "minimal" | "low" | "medium" | "high" | "max"
208
+
209
+ // Memory injection (see "Memory Injection" below)
210
+ "injection": {
211
+ "sessionStart": ["directives", "summary", "peerCard"],
212
+ "perTurn": ["userContext"]
213
+ },
214
+
215
+ // On-demand recall tool (see "The honcho_remember Tool" below)
216
+ "rememberTool": false,
196
217
 
197
218
  // Observation mode
198
219
  "observationMode": "unified", // "unified" (default) | "directional"
@@ -204,7 +225,8 @@ All configuration lives in a single global file at `~/.honcho/config.json`. You
204
225
  },
205
226
 
206
227
  // Miscellaneous
207
- "localContext": { "maxEntries": 50 }, // Max entries in claude-context.md
228
+ "redactPatterns": [], // Extra regexes redacted from tool summaries (additive to built-in secret patterns)
229
+ "statusline": "on", // Memory statusline visibility: "on" | "off"
208
230
  "enabled": true,
209
231
  "logging": true,
210
232
 
@@ -223,6 +245,67 @@ Session strategy controls how Honcho maps your conversations to sessions. Change
223
245
  | `git-branch` | Session name includes the current git branch. Switching branches switches sessions. | Feature-branch workflows where context per branch matters |
224
246
  | `chat-instance` | Each Claude Code chat gets its own session. No continuity between restarts. | Ephemeral usage, experimentation, or when you want a clean slate each time |
225
247
 
248
+ ### Memory Injection
249
+
250
+ The `injection` config block controls exactly what memory is injected into Claude's context, on two surfaces: **once at session start** and **per prompt**. Each surface selects zero or more components; retrieval knobs shape what those components emit. Configure it with `/honcho:config` (memory injection settings), `set_config`, or by editing `~/.honcho/config.json`.
251
+
252
+ **Session-start components** (default: `["directives", "summary", "peerCard"]`):
253
+
254
+ | Component | What it injects |
255
+ | --- | --- |
256
+ | `directives` | Static memory-usage guidance — treat injected memory as background, use `chat`/`search` for recall, save insights with `create_conclusion` |
257
+ | `summary` | The session's long summary narrative (skipped on a fresh session) |
258
+ | `peerCard` | Your peer card — a structured identity/attribute list |
259
+ | `peerRepresentation` | Your full derived representation, injected at full length |
260
+ | `briefing` | A nudge for Claude to call the `get_briefing` MCP tool instead of injecting the summary and peer card inline — the tool call renders as an expandable row in the UI. Use it *in place of* `summary`/`peerCard`, not alongside them |
261
+
262
+ **Per-turn components** (default: `["userContext"]`):
263
+
264
+ | Component | What it injects |
265
+ | --- | --- |
266
+ | `userContext` | A fresh, prompt-scoped context fetch for *you* — conclusions selected by semantic search, shaped by the retrieval knobs below |
267
+ | `assistantContext` | The same context fetch for the AI peer — what Honcho has derived about the assistant itself |
268
+ | `sessionContext` | Recent raw messages from the currently mapped Honcho session, which can span other Claude instances sharing the session name |
269
+ | `dialectic` | A reasoned `chat()` answer over your representation, seeded from `dialecticTemplate`. Off by default — much slower than a context fetch |
270
+
271
+ **Retrieval knobs:**
272
+
273
+ | Field | Default | Description |
274
+ | --- | --- | --- |
275
+ | `searchTopK` | `10` | Top-K conclusions pulled by the context fetch's semantic search |
276
+ | `maxConclusions` | `15` | Max conclusions injected per context fetch |
277
+ | `searchMaxDistance` | `0.6` | Max cosine distance for the semantic search — lower is stricter |
278
+ | `searchQuerySource` | `"prompt"` | What drives the per-turn search: the raw `"prompt"` or extracted `"topics"` |
279
+ | `sessionContextTokens` | `1500` | Token budget for the `sessionContext` message fetch |
280
+ | `dialecticTemplate` | compact factual recall | Query template for the `dialectic` component; the prompt is substituted into `%{user_query}` |
281
+ | `dialecticReasoning` | `"medium"` | Reasoning tier for the per-turn `dialectic` call — separate from the top-level `reasoningLevel` |
282
+
283
+ If injected context feels off-topic, lower `searchMaxDistance`; if too sparse, raise it or bump `searchTopK`.
284
+
285
+ **Visibility:** per-turn components report a one-line summary in the terminal by default. To print a component's full injected payload, list it in `showContents`:
286
+
287
+ ```json
288
+ { "injection": { "showContents": ["userContext", "sessionContext"] } }
289
+ ```
290
+
291
+ ### The `honcho_remember` Tool
292
+
293
+ An experimental on-demand recall tool. When enabled, Claude gets a `honcho_remember` MCP tool that fans out up to 5 parallel dialectic queries about you and returns per-question answers — useful before starting a task, when catching up ("where were we?"), or whenever your history could shape the response.
294
+
295
+ To enable it, just ask Claude: *"Set my Honcho rememberTool config to true"* (it uses the `set_config` tool). Or set it in `~/.honcho/config.json`:
296
+
297
+ ```json
298
+ {
299
+ "hosts": {
300
+ "claude_code": { "rememberTool": true }
301
+ }
302
+ }
303
+ ```
304
+
305
+ Then restart Claude Code — MCP tools register at startup.
306
+
307
+ When it's on, the injected session-start directives steer Claude to use it proactively as the primary recall path.
308
+
226
309
  ### Observation Mode
227
310
 
228
311
  Controls how Honcho stores and retrieves conclusions about you. Change it via `set_config` or edit `config.json` directly. Requires a Claude Code restart.