hippo-memory 1.70.0 → 1.72.0

package/dist/graph/view.d.ts

@@ -1,12 +1,5 @@
-/**
- * Graph observability and visualization, READ-ONLY over the entity/relation
- * graph.
- *
- * This module only READS the graph (through the store's graph reads) and renders
- * view-models; it issues no INSERT/UPDATE/DELETE, so `scripts/check-graph-writes.mjs`
- * stays green. Used by the CLI (`hippo graph show` / `hippo graph view`) and the
- * HTTP `GET /v1/graph` route, which all build the same `GraphModel`.
- */
+/** Graph observability and visualization, READ-ONLY over the entity/relation graph (no writes, so `scripts/check-graph-writes.mjs` stays green).
+ *  Shared by `hippo graph show|view` and the HTTP `GET /v1/graph` route, which all build the same `GraphModel`. */
 import type { GraphRows } from '../store/port.js';
 import type { EntityType, RelationType } from '../store/graph-rows.js';
 export interface GraphNode {
@@ -28,12 +21,8 @@ export interface GraphModel {
 }
 /** Default bound for the CLI viewer / show so an unbounded set is never laid out. */
 export declare const DEFAULT_VIEW_LIMIT = 500;
-/**
- * Build the view-model from the graph (reads only). With `opts.entity`, returns a
- * focus subgraph: every entity whose name === entity, plus their 1-hop neighbours,
- * plus the edges among that union. Dangling edges (an endpoint outside the node
- * set) are always dropped.
- */
+/** Build the view-model (reads only); with `opts.entity`, a focus subgraph of the entities named so plus their 1-hop neighbours.
+ *  Dangling edges (an endpoint outside the node set) are always dropped. */
 export declare function buildGraphModel(hippoRoot: string, tenantId: string, opts?: {
     entity?: string;
     limit?: number;
@@ -41,12 +30,8 @@ export declare function buildGraphModel(hippoRoot: string, tenantId: string, opt
 }): GraphModel;
 /** The reply model of the rows a store read: an edge with an endpoint outside the node set is dropped. */
 export declare function graphModelOf({ entities, relations, truncated }: GraphRows): GraphModel;
-/**
- * Deterministic Fruchterman-Reingold-style force layout. Seeded circular init +
- * fixed iterations, NO `Math.random`, so the same model always yields the same
- * positions (testable, stable output). Non-finite coordinates from a degenerate
- * step are clamped to the viewport centre; all positions are clamped in-bounds.
- */
+/** Deterministic Fruchterman-Reingold-style force layout: seeded circular init, fixed iterations, no `Math.random`, so one model gives the same positions.
+ *  Non-finite coordinates are clamped to the viewport centre and all positions to the bounds. */
 export declare function layoutGraph(model: GraphModel, opts?: {
     width?: number;
     height?: number;
@@ -57,20 +42,9 @@ export declare function layoutGraph(model: GraphModel, opts?: {
 }>;
 /** HTML-escape for SVG text / title / markup content (XSS guard). */
 export declare function escapeHtml(s: string): string;
-/**
- * Render the model as a SELF-CONTAINED, dependency-free, offline interactive HTML
- * node-link diagram. Positions are computed server-side (deterministic). User
- * strings are escaped per sink: SVG `<text>`/`<title>` via `escapeHtml`; the model
- * is inlined in a `<script type="application/json">` block with `<`/`>`/`&`
- * unicode-escaped so a `</script>` inside an entity name cannot break out (the
- * client `JSON.parse`s it back and never `innerHTML`s a user string).
- */
+/** Render the model as a self-contained, offline interactive HTML node-link diagram with server-side deterministic positions.
+ *  The model is inlined as `<script type="application/json">` with `<`, `>`, `&` unicode-escaped so a `</script>` in an entity name cannot break out. */
 export declare function renderGraphHtml(model: GraphModel): string;
-/**
- * Render the model as a JSON Canvas (jsoncanvas.org) document — `nodes[]` of
- * type `text` positioned by the same deterministic layout, `edges[]` linking
- * them by id. Opens natively in Obsidian. Pure JSON; entity names live in the
- * `text` field (Obsidian renders/sanitizes them).
- */
+/** Render the model as a JSON Canvas (jsoncanvas.org) document: `text` nodes at the same deterministic layout positions, `edges[]` linking them by id. */
 export declare function renderGraphCanvas(model: GraphModel): string;
 //# sourceMappingURL=view.d.ts.map

package/dist/graph/view.js

@@ -1,24 +1,13 @@
-/**
- * Graph observability and visualization, READ-ONLY over the entity/relation
- * graph.
- *
- * This module only READS the graph (through the store's graph reads) and renders
- * view-models; it issues no INSERT/UPDATE/DELETE, so `scripts/check-graph-writes.mjs`
- * stays green. Used by the CLI (`hippo graph show` / `hippo graph view`) and the
- * HTTP `GET /v1/graph` route, which all build the same `GraphModel`.
- */
+/** Graph observability and visualization, READ-ONLY over the entity/relation graph (no writes, so `scripts/check-graph-writes.mjs` stays green).
+ *  Shared by `hippo graph show|view` and the HTTP `GET /v1/graph` route, which all build the same `GraphModel`. */
 import { withGraphReadSnapshot } from '../store/graph-reads.js';
 import { graphViewRows } from '../store/graph-view-rows.js';
 const DEFAULT_LAYOUT_ITERATIONS = 300;
 const NODE_LABEL_MAX_CHARS = 22;
 /** Default bound for the CLI viewer / show so an unbounded set is never laid out. */
 export const DEFAULT_VIEW_LIMIT = 500;
-/**
- * Build the view-model from the graph (reads only). With `opts.entity`, returns a
- * focus subgraph: every entity whose name === entity, plus their 1-hop neighbours,
- * plus the edges among that union. Dangling edges (an endpoint outside the node
- * set) are always dropped.
- */
+/** Build the view-model (reads only); with `opts.entity`, a focus subgraph of the entities named so plus their 1-hop neighbours.
+ *  Dangling edges (an endpoint outside the node set) are always dropped. */
 export function buildGraphModel(hippoRoot, tenantId, opts = {}) {
     const limit = opts.limit ?? DEFAULT_VIEW_LIMIT;
     // One read snapshot, so a concurrent graph rebuild cannot make the model mix old entity ids with new relation ids.
@@ -105,12 +94,8 @@ function applyDisplacement(nodes, pos, disp, temp, width, height) {
         p.y = Math.max(20, Math.min(height - 20, ny));
     });
 }
-/**
- * Deterministic Fruchterman-Reingold-style force layout. Seeded circular init +
- * fixed iterations, NO `Math.random`, so the same model always yields the same
- * positions (testable, stable output). Non-finite coordinates from a degenerate
- * step are clamped to the viewport centre; all positions are clamped in-bounds.
- */
+/** Deterministic Fruchterman-Reingold-style force layout: seeded circular init, fixed iterations, no `Math.random`, so one model gives the same positions.
+ *  Non-finite coordinates are clamped to the viewport centre and all positions to the bounds. */
 export function layoutGraph(model, opts = {}) {
     const width = opts.width ?? LAYOUT_W;
     const height = opts.height ?? LAYOUT_H;
@@ -150,10 +135,8 @@ const NODE_COLORS = {
     person: '#3b82f6',
     system: '#64748b',
 };
-// Client script: pan (drag bg), zoom (wheel), click-to-highlight a node's edges +
-// neighbours. Reads the inlined model via JSON.parse (never innerHTML), so user
-// strings never reach an HTML sink here. No template literals / `${}` so it nests
-// safely inside this module's own template strings.
+// Client script: pan, zoom, click-to-highlight. It reads the inlined model via JSON.parse (never innerHTML)
+// and uses no template literals or `${}`, so it nests in this module's template strings.
 const CLIENT_JS = [
     "(function(){",
     "  var svg=document.getElementById('g');",
@@ -163,15 +146,23 @@ const CLIENT_JS = [
     "  var panning=false,sx=0,sy=0;",
     "  svg.addEventListener('mousedown',function(e){if(e.target.closest('.node'))return;panning=true;sx=e.clientX;sy=e.clientY;});",
     "  window.addEventListener('mouseup',function(){panning=false;});",
-    "  window.addEventListener('mousemove',function(e){if(!panning)return;var r=svg.getBoundingClientRect();var k=view.w/r.width;view.x-=(e.clientX-sx)*k;view.y-=(e.clientY-sy)*k;sx=e.clientX;sy=e.clientY;apply();});",
-    "  svg.addEventListener('wheel',function(e){e.preventDefault();var r=svg.getBoundingClientRect();var mx=view.x+(e.clientX-r.left)/r.width*view.w;var my=view.y+(e.clientY-r.top)/r.height*view.h;var f=e.deltaY<0?0.9:1.1;view.x=mx-(mx-view.x)*f;view.y=my-(my-view.y)*f;view.w*=f;view.h*=f;apply();},{passive:false});",
-    "  var data={};try{data=JSON.parse(document.getElementById('graph-data').textContent);}catch(_){}",
+    "  window.addEventListener('mousemove',function(e){if(!panning)return;var r=svg.getBoundingClientRect();var " +
+        "k=view.w/r.width;view.x-=(e.clientX-sx)*k;view.y-=(e.clientY-sy)*k;sx=e.clientX;sy=e.clientY;apply();});",
+    "  svg.addEventListener('wheel',function(e){e.preventDefault();var r=svg.getBoundingClientRect();var mx=view.x+(e.clientX-r.left)/r.width*view.w;var " +
+        "my=view.y+(e.clientY-r.top)/r.height*view.h;var " +
+        "f=e.deltaY<0?0.9:1.1;view.x=mx-(mx-view.x)*f;view.y=my-(my-view.y)*f;view.w*=f;view.h*=f;apply();},{passive:false});",
+    "  var data={};try{data=JSON.parse(document.getElementById('graph-data').textContent);}",
+    "  catch(e){console.error('hippo graph: embedded model is not valid JSON',e);}",
     "  var adj={};(data.edges||[]).forEach(function(e){(adj[e.from]=adj[e.from]||[]).push(e.to);(adj[e.to]=adj[e.to]||[]).push(e.from);});",
     "  var active=null;",
-    "  document.querySelectorAll('.node').forEach(function(g){g.addEventListener('click',function(ev){ev.stopPropagation();var id=g.getAttribute('data-id');if(active===id){clearHi();active=null;return;}active=id;highlight(id);});});",
+    "  document.querySelectorAll('.node').forEach(function(g){g.addEventListener('click',function(ev){ev.stopPropagation();var " +
+        "id=g.getAttribute('data-id');if(active===id){clearHi();active=null;return;}active=id;highlight(id);});});",
     "  svg.addEventListener('click',function(){clearHi();active=null;});",
     "  function clearHi(){svg.classList.remove('focused');document.querySelectorAll('.hi').forEach(function(el){el.classList.remove('hi');});}",
-    "  function highlight(id){clearHi();svg.classList.add('focused');var keep={};keep[id]=1;(adj[id]||[]).forEach(function(n){keep[n]=1;});document.querySelectorAll('.node').forEach(function(g){if(keep[g.getAttribute('data-id')])g.classList.add('hi');});document.querySelectorAll('.edge').forEach(function(l){if(l.getAttribute('data-from')===id||l.getAttribute('data-to')===id)l.classList.add('hi');});}",
+    "  function highlight(id){clearHi();svg.classList.add('focused');var " +
+        "keep={};keep[id]=1;(adj[id]||[]).forEach(function(n){keep[n]=1;});document.querySelectorAll('.node').forEach(" +
+        "function(g){if(keep[g.getAttribute('data-id')])g.classList.add('hi');});document.querySelectorAll('.edge').forEach(" +
+        "function(l){if(l.getAttribute('data-from')===id||l.getAttribute('data-to')===id)l.classList.add('hi');});}",
     "})();",
 ].join("\n");
 const STYLE = [
@@ -231,14 +222,8 @@ function renderLegend(model) {
         .map((t) => `<span style="color:${nodeColor(t)}">●</span> ${escapeHtml(t)}`)
         .join('  ');
 }
-/**
- * Render the model as a SELF-CONTAINED, dependency-free, offline interactive HTML
- * node-link diagram. Positions are computed server-side (deterministic). User
- * strings are escaped per sink: SVG `<text>`/`<title>` via `escapeHtml`; the model
- * is inlined in a `<script type="application/json">` block with `<`/`>`/`&`
- * unicode-escaped so a `</script>` inside an entity name cannot break out (the
- * client `JSON.parse`s it back and never `innerHTML`s a user string).
- */
+/** Render the model as a self-contained, offline interactive HTML node-link diagram with server-side deterministic positions.
+ *  The model is inlined as `<script type="application/json">` with `<`, `>`, `&` unicode-escaped so a `</script>` in an entity name cannot break out. */
 export function renderGraphHtml(model) {
     const pos = layoutGraph(model);
     const edgeSvg = renderEdgeSvg(model, pos);
@@ -262,12 +247,7 @@ export function renderGraphHtml(model) {
         '</body></html>',
     ].join('\n');
 }
-/**
- * Render the model as a JSON Canvas (jsoncanvas.org) document — `nodes[]` of
- * type `text` positioned by the same deterministic layout, `edges[]` linking
- * them by id. Opens natively in Obsidian. Pure JSON; entity names live in the
- * `text` field (Obsidian renders/sanitizes them).
- */
+/** Render the model as a JSON Canvas (jsoncanvas.org) document: `text` nodes at the same deterministic layout positions, `edges[]` linking them by id. */
 export function renderGraphCanvas(model) {
     const pos = layoutGraph(model, { width: 2400, height: 1600 });
     const nodes = model.nodes.map((node) => {

package/dist/graph/write.d.ts

@@ -6,7 +6,7 @@ export interface ApplyGraphOpsResult {
 }
 /** Applies `ops` from index `opts.from` on the caller's open transaction and stops at the first op boundary past `opts.holdMs`.
  *  Returns where the next chunk starts and how many ops were skipped as stale. */
-export declare function applyGraphOps(db: DatabaseSyncLike, hippoRoot: string, tenantId: string, ops: readonly GraphOp[], opts: {
+export declare function applyGraphOps(db: DatabaseSyncLike, tenantId: string, ops: readonly GraphOp[], opts: {
     readonly from: number;
     readonly holdMs: number;
     readonly clock?: () => number;

package/dist/graph/write.js

@@ -1,19 +1,19 @@
 // Applies a rebuild's op list on the caller's transaction. The statements and the consolidated-source guard sit in the store's graph writers.
 import { assertTenantId } from '../store/tenant.js';
 import { clock } from '../util/write-budget.js';
-import { deleteEntityRow, deleteRelationRow, entityIdBySource, insertEntity, insertRelation, objectInForce, relationPresent, updateEntity } from '../store/graph-writes.js';
-function insertDesiredRelation(db, hippoRoot, tenantId, rel) {
+import { deleteEntityRow, deleteRelationRow, entityIdBySource, insertEntityRow, insertRelationRow, objectInForce, relationPresent, updateEntityRow } from '../store/graph-writes.js';
+function insertDesiredRelation(db, tenantId, rel) {
     const fromEntityId = entityIdBySource(db, tenantId, rel.from.entityType, rel.from.sourceObject);
     const toEntityId = entityIdBySource(db, tenantId, rel.to.entityType, rel.to.sourceObject);
     if (fromEntityId === undefined || toEntityId === undefined || !objectInForce(db, tenantId, rel.sourceObject))
         return false;
     if (relationPresent(db, tenantId, fromEntityId, toEntityId, rel.relType))
         return false;
-    insertRelation(hippoRoot, tenantId, { fromEntityId, toEntityId, relType: rel.relType, memoryId: rel.memoryId, sourceObject: rel.sourceObject }, db);
+    insertRelationRow(db, tenantId, { fromEntityId, toEntityId, relType: rel.relType, memoryId: rel.memoryId, sourceObject: rel.sourceObject });
     return true;
 }
 /** Applies one op; false when a writer since the diff made it stale, which the next run's diff repairs. */
-function applyGraphOp(db, hippoRoot, tenantId, op) {
+function applyGraphOp(db, tenantId, op) {
     switch (op.op) {
         case 'deleteEntity':
             deleteEntityRow(db, tenantId, op.id);
@@ -24,27 +24,27 @@ function applyGraphOp(db, hippoRoot, tenantId, op) {
         case 'updateEntity':
             if (!objectInForce(db, tenantId, op.entity.sourceObject))
                 return false;
-            return updateEntity(hippoRoot, tenantId, op.id, op.entity, db) !== null;
+            return updateEntityRow(db, tenantId, op.id, op.entity) !== null;
         case 'insertEntity':
             // A mirrorless object closed since the load is never enqueued again, so a stale insert would stay for good.
             if (!objectInForce(db, tenantId, op.entity.sourceObject) || entityIdBySource(db, tenantId, op.entity.entityType, op.entity.sourceObject) !== undefined)
                 return false;
-            insertEntity(hippoRoot, tenantId, op.entity, db);
+            insertEntityRow(db, tenantId, op.entity);
             return true;
         case 'insertRelation':
-            return insertDesiredRelation(db, hippoRoot, tenantId, op.relation);
+            return insertDesiredRelation(db, tenantId, op.relation);
     }
 }
 /** Applies `ops` from index `opts.from` on the caller's open transaction and stops at the first op boundary past `opts.holdMs`.
  *  Returns where the next chunk starts and how many ops were skipped as stale. */
-export function applyGraphOps(db, hippoRoot, tenantId, ops, opts) {
+export function applyGraphOps(db, tenantId, ops, opts) {
     assertTenantId('applyGraphOps', tenantId);
     const now = opts.clock ?? clock;
     const begunAt = now();
     let next = opts.from;
     let skipped = 0;
     while (next < ops.length) {
-        if (!applyGraphOp(db, hippoRoot, tenantId, ops[next]))
+        if (!applyGraphOp(db, tenantId, ops[next]))
             skipped += 1;
         next += 1;
         if (now() - begunAt >= opts.holdMs)

package/dist/hooks/codex-session.js

@@ -1,6 +1,7 @@
 import * as fs from 'fs';
 import * as path from 'path';
 import { isJsonString } from '../util/json.js';
+import { errorMessage, log } from '../util/log.js';
 function collectFiles(dir) {
     if (!fs.existsSync(dir))
         return [];
@@ -42,8 +43,8 @@ function readCodexSessionIdsFromHistoryDelta(historyPath, startOffsetBytes) {
                 ordered.push(sessionId);
             }
         }
-        catch {
-            // ignore malformed JSONL lines
+        catch (err) {
+            log.warn(`codex history ${historyPath}: skipped a malformed JSONL line (${errorMessage(err)})`);
         }
     }
     return ordered;

package/dist/hooks/codex-wrapper.js

@@ -1,9 +1,10 @@
 import { envPath } from '../util/env.js';
 import * as fs from 'fs';
 import * as path from 'path';
-import { fileURLToPath } from 'url';
+import { PACKAGE_ROOT } from '../core/package-root.js';
 import { errorMessage, log } from '../util/log.js';
-import { HIPPO_CODEX_WRAPPER_MARKER, homeDir, codexHomeDir, ensureDir } from './shared.js';
+import { HIPPO_CODEX_WRAPPER_MARKER, ensureDir } from './shared.js';
+import { homeDir, codexHomeDir } from '../util/agent-homes.js';
 import { isJsonString } from '../util/json.js';
 import { writeFileAtomic } from '../util/atomic-write.js';
 export function resolveCodexWrapperPaths() {
@@ -68,7 +69,7 @@ function isCodexWrapperMetadataValid(metadata) {
         isHippoCodexWrapperFile(metadata.commandPath));
 }
 function resolveHippoCliPath() {
-    return fileURLToPath(new URL('../bin/hippo.js', import.meta.url));
+    return path.join(PACKAGE_ROOT, 'bin', 'hippo.js');
 }
 function quoteForShell(value) {
     return `"${value.replace(/(["\\$`])/g, '\\$1')}"`;

package/dist/hooks/copilot.js

@@ -77,7 +77,8 @@ function hippoCommand() {
 export const COPILOT_CLI_MCP = { key: 'mcpServers', server: () => ({ type: 'local', command: hippoCommand(), args: ['mcp'], env: {}, tools: ['*'] }) };
 /** VS Code's mcp.json keeps stdio servers under "servers"; it has no "mcpServers" key. */
 export const VSCODE_MCP = { key: 'servers', server: () => ({ type: 'stdio', command: hippoCommand(), args: ['mcp'] }) };
-/** Only a server hippo wrote counts as hippo's: another command, other args, or any key or value setup does not write (an env you added) makes it the user's. */
+/** Only a server hippo wrote counts as hippo's: another command, other args, or
+ * any key or value setup does not write (an env you added) makes it the user's. */
 function isHipposServer(entry, host) {
     if (!isJsonObjectLiteral(entry) || !('command' in entry) || !('args' in entry))
         return false;

package/dist/hooks/hook-blocks.d.ts

@@ -2,11 +2,15 @@ export declare const HOOK_MARKERS: {
     start: string;
     end: string;
 };
-export declare const HOOKS: Record<string, {
+export interface HookSpec {
     file: string;
     content: string;
     description: string;
-}>;
+}
+export interface HookTable {
+    [agent: string]: HookSpec;
+}
+export declare const HOOKS: HookTable;
 /** The first hippo block in `text` and the agent whose current or shipped text it is; `owner` is undefined for an edited block. */
 export declare function hippoBlock(text: string): {
     start: number;

package/dist/hooks/hook-blocks.js

@@ -5,71 +5,22 @@ export const HOOK_MARKERS = {
     start: '<!-- hippo:start -->',
     end: '<!-- hippo:end -->',
 };
-export const HOOKS = {
-    'claude-code': {
-        file: 'CLAUDE.md',
-        description: 'Claude Code',
-        content: `
-## Project Memory (Hippo)
-
-Pinned rules and recent writes auto-inject at every prompt via the installed
-UserPromptSubmit hook; never re-run that part manually. At the START of a
-task (not per prompt), additionally load task-specific context: git-aware
-recall over the full store that per-prompt injection does not cover. Also
-run it if the hook is not installed:
-\`\`\`bash
-hippo context --auto --budget 1500
-\`\`\`
-
-When you find out why something failed, record it right then, while you
-work, never as a closing step:
-\`\`\`bash
-hippo remember "<what went wrong and why>" --error
-\`\`\`
-
-The installed hooks store failed tool calls and capture the session when it
-ends, so there is nothing to run before you finish.
-`.trim(),
-    },
-    'codex': {
-        file: 'AGENTS.md',
-        description: 'OpenAI Codex',
-        content: `
-## Project Memory (Hippo)
-
-At the start of every task, run:
-\`\`\`bash
-hippo context --auto --budget 1500
-\`\`\`
-Read the output before writing any code.
-
-On errors or unexpected behaviour, record it right then, while you work,
-never as a closing step:
-\`\`\`bash
-hippo remember "<description of what went wrong>" --error
-\`\`\`
-
-When you learn something that should outlive this session (a decision and
-its reason, a user preference, a lesson), record it right then, while you
-work, never as a closing step. Leave out secrets and personal details:
-\`\`\`bash
-hippo remember "<what you learned and why>"
-\`\`\`
-
-When Hippo's Codex wrapper is installed, session-end capture runs automatically.
-If the wrapper is not installed, capture a brief summary manually:
+// Shared by the agents that differ only in the noun, an optional recall paragraph and an optional footer.
+const PI_FOOTER = 'For full integration, copy the hippo-memory Pi extension to `~/.pi/agent/extensions/hippo-memory/`.';
+function agentsBlock(noun, opts = {}) {
+    const recall = opts.recall
+        ? `
+When stuck or repeating yourself, check if this happened before:
 \`\`\`bash
-hippo capture --stdin <<< '<decisions, errors, lessons: 2-5 bullets>'
+hippo recall "<what's going wrong>" --budget 2000
 \`\`\`
-`.trim(),
-    },
-    'cursor': {
-        file: 'AGENTS.md',
-        description: 'Cursor',
-        content: `
+`
+        : '';
+    const footer = opts.footer ? `\n${opts.footer}\n` : '';
+    return `
 ## Project Memory (Hippo)
 
-At the start of every task, run:
+At the start of every ${noun}, run:
 \`\`\`bash
 hippo context --auto --budget 1500
 \`\`\`
@@ -87,47 +38,42 @@ work, never as a closing step. Leave out secrets and personal details:
 \`\`\`bash
 hippo remember "<what you learned and why>"
 \`\`\`
-
+${recall}
 When ending a session, capture a brief summary:
 \`\`\`bash
 hippo capture --stdin <<< '<decisions, errors, lessons: 2-5 bullets>'
 \`\`\`
-`.trim(),
-    },
-    'openclaw': {
-        file: 'AGENTS.md',
-        description: 'OpenClaw',
+${footer}`.trim();
+}
+export const HOOKS = {
+    'claude-code': {
+        file: 'CLAUDE.md',
+        description: 'Claude Code',
         content: `
 ## Project Memory (Hippo)
 
-At the start of every session, run:
+Pinned rules and recent writes auto-inject at every prompt via the installed
+UserPromptSubmit hook; never re-run that part manually. At the START of a
+task (not per prompt), additionally load task-specific context: git-aware
+recall over the full store that per-prompt injection does not cover. Also
+run it if the hook is not installed:
 \`\`\`bash
 hippo context --auto --budget 1500
 \`\`\`
-Read the output before writing any code.
 
-On errors or unexpected behaviour, record it right then, while you work,
-never as a closing step:
-\`\`\`bash
-hippo remember "<description of what went wrong>" --error
-\`\`\`
-
-When you learn something that should outlive this session (a decision and
-its reason, a user preference, a lesson), record it right then, while you
-work, never as a closing step. Leave out secrets and personal details:
+When you find out why something failed, record it right then, while you
+work, never as a closing step:
 \`\`\`bash
-hippo remember "<what you learned and why>"
+hippo remember "<what went wrong and why>" --error
 \`\`\`
 
-When ending a session, capture a brief summary:
-\`\`\`bash
-hippo capture --stdin <<< '<decisions, errors, lessons: 2-5 bullets>'
-\`\`\`
+The installed hooks store failed tool calls and capture the session when it
+ends, so there is nothing to run before you finish.
 `.trim(),
     },
-    'opencode': {
+    'codex': {
         file: 'AGENTS.md',
-        description: 'OpenCode',
+        description: 'OpenAI Codex',
         content: `
 ## Project Memory (Hippo)
 
@@ -150,50 +96,17 @@ work, never as a closing step. Leave out secrets and personal details:
 hippo remember "<what you learned and why>"
 \`\`\`
 
-When stuck or repeating yourself, check if this happened before:
-\`\`\`bash
-hippo recall "<what's going wrong>" --budget 2000
-\`\`\`
-
-When ending a session, capture a brief summary:
-\`\`\`bash
-hippo capture --stdin <<< '<decisions, errors, lessons: 2-5 bullets>'
-\`\`\`
-`.trim(),
-    },
-    'pi': {
-        file: 'AGENTS.md',
-        description: 'Pi',
-        content: `
-## Project Memory (Hippo)
-
-At the start of every session, run:
-\`\`\`bash
-hippo context --auto --budget 1500
-\`\`\`
-Read the output before writing any code.
-
-On errors or unexpected behaviour, record it right then, while you work,
-never as a closing step:
-\`\`\`bash
-hippo remember "<description of what went wrong>" --error
-\`\`\`
-
-When you learn something that should outlive this session (a decision and
-its reason, a user preference, a lesson), record it right then, while you
-work, never as a closing step. Leave out secrets and personal details:
-\`\`\`bash
-hippo remember "<what you learned and why>"
-\`\`\`
-
-When ending a session, capture a brief summary:
+When Hippo's Codex wrapper is installed, session-end capture runs automatically.
+If the wrapper is not installed, capture a brief summary manually:
 \`\`\`bash
 hippo capture --stdin <<< '<decisions, errors, lessons: 2-5 bullets>'
 \`\`\`
-
-For full integration, copy the hippo-memory Pi extension to \`~/.pi/agent/extensions/hippo-memory/\`.
 `.trim(),
     },
+    'cursor': { file: 'AGENTS.md', description: 'Cursor', content: agentsBlock('task') },
+    'openclaw': { file: 'AGENTS.md', description: 'OpenClaw', content: agentsBlock('session') },
+    'opencode': { file: 'AGENTS.md', description: 'OpenCode', content: agentsBlock('task', { recall: true }) },
+    'pi': { file: 'AGENTS.md', description: 'Pi', content: agentsBlock('session', { footer: PI_FOOTER }) },
 };
 // sha256 of each trimmed block an earlier hippo wrote, so init refreshes only blocks nobody edited. Add the old hash when a block changes.
 const SHIPPED_HOOK_HASHES = new Map([

package/dist/hooks/json-hooks.d.ts

@@ -1,38 +1,5 @@
-/**
- * Hook install/uninstall for AI coding tools.
- *
- * Two integration models live in this file:
- *
- * 1. JSON-hook install (Claude Code only). Writes a `hooks` block into the
- *    tool's settings.json with two entries:
- *      - SessionEnd: `hippo session-end --log-file <path>` - spawns a detached
- *        child that runs `hippo sleep` then `hippo capture --last-session` in
- *        sequence, writing both outputs to the log file. The parent returns in
- *        <100ms so the TUI teardown can't kill the child before it finishes.
- *      - SessionStart: `hippo last-sleep --path <path>` - prints the log
- *        written by the previous session's detached worker on stderr and
- *        clears it. Stdout carries only a `systemMessage` problems line,
- *        because Claude Code shows that to the user, not the model.
- *    Earlier Claude Code forms are detected and migrated automatically:
- *      - < 0.20.2: `Stop` hook firing `hippo sleep` on every assistant turn.
- *      - < 0.21.0: bare `hippo sleep` in SessionEnd, no `--log-file`.
- *      - 0.22.x: separate sleep + capture SessionEnd entries.
- *    PreCompact and PostCompact entries go in too: the first records the compaction and
- *    asks the summariser for a "Memories for hippo" list, the second saves that list.
- *    Codex's hooks.json gets only two groups (per-prompt memory and
- *    compact-resume); see installCodexHooks. Copilot gets a file of its own; see installCopilotHooks.
- *
- * 2. Plugin install (OpenCode only). OpenCode does NOT share Claude Code's
- *    JSON-hook schema — its config has `additionalProperties: false` and no
- *    `hooks` key, so a JSON-hook install breaks opencode launch. Hippo
- *    installs a TypeScript plugin at
- *    `~/.config/opencode/plugins/hippo.ts` subscribing to opencode's
- *    `session.idle` (→ `hippo session-end`) and `session.created` (→
- *    `hippo last-sleep`) events. See OPENCODE_PLUGIN_SOURCE below for the
- *    plugin file content + design rationale; see installOpencodePlugin for
- *    the installer + the migration that removes any pre-existing broken
- *    `hooks` block from opencode.json.
- */
+/** Hook install/uninstall for AI coding tools. Claude Code gets a JSON `hooks` block in settings.json; older forms are migrated automatically.
+ * OpenCode rejects the JSON-hook schema (no `hooks` key), so it gets a TS plugin (OPENCODE_PLUGIN_SOURCE); see installCodexHooks, installCopilotHooks. */
 import { type JsonHookTarget } from './shared.js';
 import { type JsonValue } from '../util/json.js';
 /** A target's hook settings file, the log its SessionEnd hook writes, and the tool's display name. */
@@ -71,6 +38,7 @@ export declare function installJsonHooks(target: JsonHookTarget): InstallResult;
 export declare function writeSettingsFile(file: string, settings: JsonValue): void;
 /** Removes hippo's own hook handlers from `target`'s settings file and keeps every other handler; true when the file changed. */
 export declare function uninstallJsonHooks(target: JsonHookTarget): boolean;
-/** Whether uninstall can edit settings.json; `invalidJson` marks a file that exists but is not JSON hippo can edit, which `uninstallJsonHooks` reports only as false. */
+/** Whether uninstall can edit settings.json; `invalidJson` marks a file that exists
+ * but is not JSON hippo can edit, which `uninstallJsonHooks` reports only as false. */
 export declare function checkUninstallable(target: JsonHookTarget): Pick<InstallResult, 'settingsPath' | 'invalidJson'>;
 //# sourceMappingURL=json-hooks.d.ts.map