#1 Persistent memory for AI coding agents based on real-world benchmarks
TypeScript agentmemoryagentsaiclaudeclaudecodecodexcopilotcursorgenaiharnesshermesmemoryompopenclawopencodepi
#!/usr/bin/env node
import { resolveClientSecret } from "../secret-store.js";
function isSdkChildContext(payload: unknown): boolean {
if (process.env["AGENTMEMORY_SDK_CHILD"] === "1") return true;
if (!payload || typeof payload !== "object") return false;
return (payload as { entrypoint?: unknown }).entrypoint === "sdk-ts";
}
const INJECT_CONTEXT = process.env["AGENTMEMORY_INJECT_CONTEXT"] === "true";
const REST_URL = process.env["AGENTMEMORY_URL"] || "http://localhost:3111";
const SECRET = resolveClientSecret(REST_URL);
function authHeaders(): Record<string, string> {
const h: Record<string, string> = { "Content-Type": "application/json" };
if (SECRET) h["Authorization"] = `Bearer ${SECRET}`;
return h;
}
async function main() {
// Default off: exit immediately so we don't even open stdin. This keeps
// Claude Code's tool-call hot path as cheap as possible.
if (!INJECT_CONTEXT) return;
let input = "";
for await (const chunk of process.stdin) {
input += chunk;
}
let data: Record<string, unknown>;
try {
data = JSON.parse(input);
} catch {
return;
}
if (!data || typeof data !== "object") return;
if (isSdkChildContext(data)) return;
const toolName =
typeof data.tool_name === "string"
? data.tool_name
: typeof data.toolName === "string"
? data.toolName
: undefined;
if (!toolName) return;
const normalizedToolName = toolName.toLowerCase();
const fileTools = ["edit", "write", "create", "read", "view", "glob", "grep"];
if (!fileTools.includes(normalizedToolName)) return;
const rawToolInput = data.tool_input ?? data.toolArgs;
const toolInput =
typeof rawToolInput === "object" &&
rawToolInput !== null &&
!Array.isArray(rawToolInput)
? (rawToolInput as Record<string, unknown>)
: {};
const files: string[] = [];
const fileKeys =
normalizedToolName === "grep"
? ["path", "file"]
: ["file_path", "path", "file", "pattern"];
for (const key of fileKeys) {
const val = toolInput[key];
if (typeof val === "string" && val.length > 0) files.push(val);
}
if (files.length === 0) return;
const terms: string[] = [];
if (normalizedToolName === "grep" || normalizedToolName === "glob") {
const pattern = toolInput["pattern"];
if (typeof pattern === "string" && pattern.length > 0) {
terms.push(pattern);
}
}
const rawSessionId = data.session_id || data.sessionId || data.conversation_id;
const sessionId =
typeof rawSessionId === "string" && rawSessionId.length > 0
? rawSessionId
: "unknown";
const project =
typeof data.project === "string" && data.project.trim().length > 0
? data.project.trim()
: undefined;
try {
const res = await fetch(`${REST_URL}/agentmemory/enrich`, {
method: "POST",
headers: authHeaders(),
body: JSON.stringify({
sessionId,
files,
terms,
toolName,
...(project !== undefined && { project }),
}),
signal: AbortSignal.timeout(2000),
});
if (res.ok) {
const result = (await res.json()) as { context?: string };
if (result.context) {
process.stdout.write(result.context);
}
}
} catch {
// don't block tool execution
}
}
main().catch(() => process.exit(0));