@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.
- package/.claude-plugin/plugin.json +1 -1
- package/README.md +95 -12
- package/dist/hooks/post-tool-use.js +16714 -29
- package/dist/hooks/post-tool-use.js.map +91 -5
- package/dist/hooks/pre-compact.js +16909 -39
- package/dist/hooks/pre-compact.js.map +92 -6
- package/dist/hooks/pre-tool-honcho.js +829 -10
- package/dist/hooks/pre-tool-honcho.js.map +10 -5
- package/dist/hooks/save-user-message.js +16552 -32
- package/dist/hooks/save-user-message.js.map +90 -5
- package/dist/hooks/session-end.js +1003 -20
- package/dist/hooks/session-end.js.map +12 -5
- package/dist/hooks/session-start.js +16961 -51
- package/dist/hooks/session-start.js.map +93 -5
- package/dist/hooks/stop.js +16681 -33
- package/dist/hooks/stop.js.map +90 -5
- package/dist/hooks/user-prompt.js +17004 -14
- package/dist/hooks/user-prompt.js.map +93 -4
- package/dist/mcp-server.js +17097 -907
- package/dist/mcp-server.js.map +88 -4
- package/dist/skills/backfill-runner.js +16309 -69
- package/dist/skills/backfill-runner.js.map +89 -4
- package/dist/skills/setup-runner.js +16185 -60
- package/dist/skills/setup-runner.js.map +88 -5
- package/dist/skills/status-runner.js +16184 -21
- package/dist/skills/status-runner.js.map +88 -4
- package/package.json +1 -1
- package/dist/chunk-084dpgp3.js +0 -556
- package/dist/chunk-084dpgp3.js.map +0 -10
- package/dist/chunk-49wja30f.js +0 -20
- package/dist/chunk-49wja30f.js.map +0 -10
- package/dist/chunk-4ryv9310.js +0 -15534
- package/dist/chunk-4ryv9310.js.map +0 -87
- package/dist/chunk-4zgbdwm4.js +0 -261
- package/dist/chunk-4zgbdwm4.js.map +0 -10
- package/dist/chunk-6yybt92z.js +0 -106
- package/dist/chunk-6yybt92z.js.map +0 -9
- package/dist/chunk-9pntsn3x.js +0 -35
- package/dist/chunk-9pntsn3x.js.map +0 -10
- package/dist/chunk-d2gc13m0.js +0 -161
- package/dist/chunk-d2gc13m0.js.map +0 -11
- package/dist/chunk-dxbm7kmf.js +0 -331
- package/dist/chunk-dxbm7kmf.js.map +0 -10
- package/dist/chunk-gnp95nzg.js +0 -438
- package/dist/chunk-gnp95nzg.js.map +0 -12
- package/dist/chunk-jgtvcc65.js +0 -90
- package/dist/chunk-jgtvcc65.js.map +0 -10
- package/dist/chunk-jr0fd6n2.js +0 -181
- package/dist/chunk-jr0fd6n2.js.map +0 -11
- package/dist/chunk-wm6hvkcv.js +0 -245
- package/dist/chunk-wm6hvkcv.js.map +0 -10
- package/dist/chunk-xdntcesh.js +0 -15450
- package/dist/chunk-xdntcesh.js.map +0 -86
- package/dist/chunk-xtdvbfxw.js +0 -146
- package/dist/chunk-xtdvbfxw.js.map +0 -10
- package/dist/chunk-yfrrc1d5.js +0 -838
- package/dist/chunk-yfrrc1d5.js.map +0 -12
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)
|
|
48
|
-
|
|
49
|
-
|
|
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
|
-
- **
|
|
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
|
|
132
|
-
|
|
|
133
|
-
| `search`
|
|
134
|
-
| `chat`
|
|
135
|
-
| `create_conclusion`
|
|
136
|
-
| `
|
|
137
|
-
| `
|
|
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
|
-
"
|
|
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.
|