pathmark 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pathmark Memory contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,339 @@
+# Pathmark Memory
+
+<p align="center">
+  <img src="assets/pathmark-icon-v3-glyph.png" alt="Pathmark" width="160">
+</p>
+
+One memory for every coding agent on your machine.
+
+Use Codex for a fix, Claude Code for review, opencode for cleanup, and Gemini CLI for a second pass. Pathmark gives each harness the same local context. Decisions, preferences, project notes, and conclusions land in one JSONL store. The next agent can pick them up without a recap.
+
+## Why Pathmark
+
+AI coding agents trap useful context inside their own sessions. You switch tools and spend the first prompt rebuilding history.
+
+Pathmark moves that context into a local MCP server:
+
+- Local JSONL store by default.
+- Standard MCP tools instead of a proprietary client.
+- Cross-harness memory: every MCP-capable coding agent can read/write the same context.
+- Works when the model lives in the MCP client.
+- Optional subscription CLI bridge for server-side synthesis.
+- Optional OpenAI-compatible API bridge for Kimi, GLM, OpenRouter, local gateways, and other compatible providers.
+- Easy to inspect, back up, delete, or migrate.
+
+Pathmark stays provider-neutral. Codex gets one optional synthesis preset. The core server works with any MCP client that can use local tools.
+
+## Cross-Harness Memory
+
+Codex remembers one set of things. Claude Code learns another. opencode starts cold. Pathmark gives them one shared trail.
+
+Point each harness at the same store:
+
+```text
+Codex       \
+Claude Code \
+opencode     >  Pathmark MCP  >  ~/.pathmark/memory/memory.jsonl
+Gemini CLI  /
+Cursor     /
+```
+
+Install Pathmark in each harness and point all of them at the same `PATHMARK_STORE_DIR`. Any tool can save context with `remember` or `create_conclusion`; any other tool can later recover it with `search_memory`, `get_context`, or `ask_memory`.
+
+Pathmark sits below the agents as a memory bus for your coding workflow.
+
+## Tools
+
+Pathmark exposes these MCP tools:
+
+| Tool | Purpose |
+| --- | --- |
+| `remember` | Save a raw memory item. |
+| `create_conclusion` | Save a higher-signal durable conclusion or preference. |
+| `search_memory` | Search memories and conclusions. |
+| `get_context` | Return compact context for a task or question. |
+| `list_conclusions` | List saved conclusions. |
+| `delete_memory` | Soft-delete a memory or conclusion by id. |
+| `ask_memory` | Return relevant context, or synthesize with `PATHMARK_CHAT_COMMAND` if configured. |
+| `chat` | Chat-compatible alias for `ask_memory`; returns the retrieved context so the client can show what was used. |
+| `get_config` | Show local store configuration. |
+
+## Quick Start
+
+```bash
+npm install -g pathmark
+```
+
+Then add the MCP server to your client.
+
+Prefer npm for normal installs. To test the current GitHub `main` branch directly:
+
+```bash
+npm install -g --install-links=true github:hacksurvivor/pathmark
+```
+
+Generate a setup snippet for your harness:
+
+```bash
+pathmark setup list
+pathmark setup claude-code
+pathmark setup opencode --json
+pathmark setup gemini-cli
+pathmark setup kimi
+```
+
+See [docs/compatibility.md](docs/compatibility.md) for Codex, Claude Code, opencode, Gemini CLI, OpenClaw, Hermes Agent, Grok CLI, Kimi, GLM, and generic MCP setups.
+
+### Codex
+
+```bash
+codex mcp add pathmark -- pathmark
+```
+
+Codex users can also enable auto-capture:
+
+```bash
+pathmark codex install --replace-honcho
+```
+
+### Claude Code
+
+```bash
+claude mcp add pathmark -- pathmark
+```
+
+### opencode / Gemini CLI
+
+Use the generated snippets:
+
+```bash
+pathmark setup opencode
+pathmark setup gemini-cli
+```
+
+### Claude Desktop
+
+Add this to your Claude Desktop MCP config:
+
+```json
+{
+  "mcpServers": {
+    "pathmark": {
+      "command": "pathmark",
+      "env": {
+        "PATHMARK_STORE_DIR": "~/.pathmark/memory"
+      }
+    }
+  }
+}
+```
+
+### Cursor
+
+Add the same command to Cursor's MCP server settings:
+
+```json
+{
+  "mcpServers": {
+    "pathmark": {
+      "command": "pathmark"
+    }
+  }
+}
+```
+
+## Local Development
+
+```bash
+npm install
+npm run build
+npm run smoke
+```
+
+Run directly:
+
+```bash
+PATHMARK_STORE_DIR=.pathmark npm run dev
+```
+
+## Migrate From Honcho
+
+Pathmark can import local `codex-honcho` JSONL memory without deleting or moving the Honcho store.
+
+```bash
+npm run import:honcho
+```
+
+Defaults:
+
+```text
+Honcho source:   ~/.honcho/codex/local
+Pathmark target: ~/.pathmark/memory/memory.jsonl
+```
+
+The importer creates a `memory.jsonl.backup-*` file before writing, uses deterministic ids so reruns skip duplicates, and redacts obvious `KEY=...`, `TOKEN=...`, `PASSWORD=...`, and `Bearer ...` values.
+
+Use a dry run first when migrating another machine:
+
+```bash
+npm run import:honcho -- --dry-run
+```
+
+## Codex Auto-Capture
+
+Install Pathmark as the Codex memory adapter:
+
+```bash
+pathmark codex install --replace-honcho
+```
+
+This registers the Pathmark MCP server, enables Codex hooks, and removes old Honcho hook commands from Codex. It does not delete or move Honcho memory; data at `~/.honcho/codex/local` is preserved.
+
+Use `--replace-honcho` when you want Pathmark hooks to take over from `codex-honcho`. Without it, Pathmark installs alongside any existing Honcho hook commands.
+
+Check the adapter status:
+
+```bash
+pathmark codex status
+```
+
+The status output is JSON and includes Pathmark hook state, MCP registration state, Honcho hook presence, the active store paths, and the current record count.
+
+Remove Pathmark hooks and MCP registration without deleting memory:
+
+```bash
+pathmark codex uninstall
+```
+
+## Configuration
+
+| Variable | Default | Description |
+| --- | --- | --- |
+| `PATHMARK_STORE_DIR` | `~/.pathmark/memory` | Directory for `memory.jsonl`. |
+| `PATHMARK_MAX_SEARCH_RESULTS` | `12` | Default search limit. |
+| `PATHMARK_SYNTHESIS_PROVIDER` | `client` | `client`, `command`, `codex`, or `openai-compatible`. |
+| `PATHMARK_CHAT_COMMAND` | unset | Command provider: receives a synthesized prompt on stdin and writes an answer on stdout. |
+| `PATHMARK_CODEX_COMMAND` | `codex` | Codex provider command. |
+| `PATHMARK_CODEX_MODEL` | unset | Optional Codex model override. |
+| `PATHMARK_OPENAI_BASE_URL` | `https://api.openai.com/v1` | OpenAI-compatible API base URL. |
+| `PATHMARK_OPENAI_API_KEY` | unset | OpenAI-compatible API key. |
+| `PATHMARK_OPENAI_MODEL` | unset | Model id for OpenAI-compatible synthesis. |
+| `PATHMARK_CHAT_TIMEOUT_MS` | `120000` | Synthesis command timeout. |
+
+## Synthesis Modes
+
+Pathmark separates memory from reasoning.
+
+### `client`
+
+Default. The MCP server returns relevant memory context, and your MCP client model synthesizes the answer. This works across Codex, Claude Desktop, Cursor, and any other MCP client without giving Pathmark a model credential.
+
+```bash
+PATHMARK_SYNTHESIS_PROVIDER=client pathmark
+```
+
+### `command`
+
+Use any local subscription or model CLI that accepts a prompt on stdin and writes an answer to stdout:
+
+```bash
+PATHMARK_SYNTHESIS_PROVIDER=command \
+PATHMARK_CHAT_COMMAND="your-ai-cli --model your-model" \
+pathmark
+```
+
+This is the general path for users with another paid subscription CLI or a local model runner.
+
+### `codex`
+
+Use the proven Codex CLI bridge. It runs a controlled, non-interactive `codex exec` turn with hooks and memories disabled to avoid recursion:
+
+```bash
+PATHMARK_SYNTHESIS_PROVIDER=codex \
+PATHMARK_CODEX_MODEL=gpt-5.5 \
+pathmark
+```
+
+This is useful for Codex users who have ChatGPT/Codex subscription auth locally but do not want to add an OpenAI API key.
+
+### `openai-compatible`
+
+Use any provider that exposes `/chat/completions`, including many Kimi, GLM/Z.ai, OpenRouter, LiteLLM, Ollama-compatible gateways, and self-hosted routers:
+
+```bash
+PATHMARK_SYNTHESIS_PROVIDER=openai-compatible \
+PATHMARK_OPENAI_BASE_URL=https://api.provider.example/v1 \
+PATHMARK_OPENAI_API_KEY=... \
+PATHMARK_OPENAI_MODEL=... \
+pathmark
+```
+
+This mode only affects `ask_memory`. Regular MCP tools still store and retrieve local memory without a model provider.
+
+## Setup CLI
+
+`pathmark setup <client>` prints copy-paste setup for common harnesses. Add `--json` when you want structured output for scripts.
+
+Supported targets:
+
+```text
+codex
+claude-code
+claude-desktop
+cursor
+opencode
+gemini-cli
+generic
+openai-compatible
+command
+```
+
+Aliases include `claude`, `gemini`, `kimi`, `glm`, and `z-ai`.
+
+## Data Format
+
+Pathmark stores newline-delimited JSON at:
+
+```text
+~/.pathmark/memory/memory.jsonl
+```
+
+Each record is inspectable:
+
+```json
+{
+  "id": "uuid",
+  "kind": "memory",
+  "text": "The user prefers local-first tools.",
+  "tags": ["preference"],
+  "source": "mcp",
+  "createdAt": "2026-06-29T00:00:00.000Z",
+  "updatedAt": "2026-06-29T00:00:00.000Z"
+}
+```
+
+Deletes are soft deletes: the record gets a `deletedAt` timestamp.
+
+## Roadmap
+
+- Harness installers for Codex, Claude Code, opencode, Gemini CLI, and other MCP clients.
+- Optional auto-capture hooks/importers per harness, so useful context can be saved with less prompting.
+- Provider presets for common local AI CLIs where stable commands exist.
+- Import/export commands for other memory systems.
+- Better ranking with optional local embeddings.
+- Namespaces for projects, teams, and clients.
+- Encrypted store option.
+- Hosted sync as an opt-in layer, not a requirement.
+- Example recipes for Codex, Claude Desktop, Cursor, ChatGPT, and local LLM tools.
+
+## Positioning
+
+Pathmark gives your agents a shared working memory that stays on your machine.
+
+> Switch agents. Keep the context.
+
+> Bring your own subscription. Keep your memory local.
+
+## License
+
+MIT

package/SECURITY.md

@@ -0,0 +1,39 @@
+# Security Policy
+
+Pathmark is local-first memory infrastructure. The default store is a JSONL file on your machine:
+
+```text
+~/.pathmark/memory/memory.jsonl
+```
+
+## Supported Version
+
+Pathmark is currently pre-1.0. Security fixes are handled on `main` and released through GitHub installs.
+
+## Data Model
+
+- Core memory tools do not require an API key or hosted account.
+- The default synthesis mode is `client`; the MCP client model reads retrieved memory context.
+- `openai-compatible`, `command`, and `codex` synthesis modes are opt-in.
+- Deletes are soft deletes inside the JSONL store.
+- Codex auto-capture redacts common secret-shaped values before storage, but users should still avoid pasting credentials into prompts.
+
+## Sensitive Data Guidance
+
+- Treat `~/.pathmark/memory/memory.jsonl` as private working data.
+- Back it up and sync it only through systems you trust.
+- Review records before sharing logs, bug reports, or screenshots.
+- Use `delete_memory` for targeted removal; manually inspect the JSONL file for high-risk cleanup.
+
+## Reporting a Vulnerability
+
+Please report security issues privately by opening a GitHub security advisory for this repository when available, or by contacting the maintainer directly through the GitHub profile.
+
+Include:
+
+- Affected version or commit.
+- Reproduction steps.
+- Whether local memory, hook config, command execution, or remote synthesis is involved.
+- Any suspected exposure path, without including real secrets.
+
+Please do not post working exploits or sensitive memory contents in public issues.

package/dist/chat.d.ts

@@ -0,0 +1,6 @@
+import type { PathmarkConfig, SearchResult } from "./types.js";
+export declare function synthesizeWithCommand(input: {
+    config: PathmarkConfig;
+    question: string;
+    context: SearchResult[];
+}): Promise<string | undefined>;

package/dist/chat.js

@@ -0,0 +1,169 @@
+import { spawn } from "node:child_process";
+export async function synthesizeWithCommand(input) {
+    if (input.config.synthesisProvider === "client")
+        return undefined;
+    const prompt = [
+        "Answer the question using the local memory context below.",
+        "If the context is insufficient, say what is missing.",
+        "",
+        `Question: ${input.question}`,
+        "",
+        "Memory context:",
+        ...input.context.map((result, index) => {
+            const record = result.record;
+            return [
+                `#${index + 1} ${record.kind} ${record.id}`,
+                `createdAt: ${record.createdAt}`,
+                `tags: ${record.tags.join(", ") || "none"}`,
+                record.text,
+            ].join("\n");
+        }),
+    ].join("\n");
+    if (input.config.synthesisProvider === "codex") {
+        return runCodex(input.config, prompt);
+    }
+    if (input.config.synthesisProvider === "openai-compatible") {
+        return runOpenAiCompatible(input.config, input.question, prompt);
+    }
+    if (!input.config.chatCommand)
+        return undefined;
+    return runShellCommand(input.config.chatCommand, prompt, input.config.chatTimeoutMs);
+}
+function runCodex(config, prompt) {
+    const args = [
+        "--ask-for-approval",
+        "never",
+        "--disable",
+        "hooks",
+        "--disable",
+        "memories",
+        "exec",
+        "--json",
+        "--ephemeral",
+        "--skip-git-repo-check",
+        "--ignore-user-config",
+        "--sandbox",
+        "read-only",
+    ];
+    if (config.codexModel)
+        args.push("--model", config.codexModel);
+    args.push(prompt);
+    return runCommand(config.codexCommand, args, "", config.chatTimeoutMs, parseCodexJsonAnswer);
+}
+async function runOpenAiCompatible(config, question, prompt) {
+    if (!config.openaiApiKey)
+        throw new Error("PATHMARK_OPENAI_API_KEY is required for openai-compatible synthesis");
+    if (!config.openaiModel)
+        throw new Error("PATHMARK_OPENAI_MODEL is required for openai-compatible synthesis");
+    const baseUrl = config.openaiBaseUrl.replace(/\/+$/, "");
+    const response = await fetch(`${baseUrl}/chat/completions`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${config.openaiApiKey}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+            model: config.openaiModel,
+            messages: [
+                {
+                    role: "system",
+                    content: "Answer using only the provided local Pathmark memory context. If the context is insufficient, say what is missing.",
+                },
+                {
+                    role: "user",
+                    content: `Question:\n${question}\n\n${prompt}`,
+                },
+            ],
+        }),
+        signal: AbortSignal.timeout(config.chatTimeoutMs),
+    });
+    if (!response.ok) {
+        const body = await response.text().catch(() => "");
+        throw new Error(`OpenAI-compatible synthesis failed (${response.status}): ${body.slice(0, 500)}`);
+    }
+    const data = (await response.json());
+    const content = data.choices?.[0]?.message?.content;
+    if (typeof content === "string")
+        return content.trim();
+    if (Array.isArray(content))
+        return content.map((part) => part.text ?? "").join("").trim();
+    return "";
+}
+function parseCodexJsonAnswer(stdout) {
+    let answer = "";
+    for (const line of stdout.split(/\r?\n/)) {
+        const trimmed = line.trim();
+        if (!trimmed.startsWith("{"))
+            continue;
+        try {
+            const event = JSON.parse(trimmed);
+            if (event.type === "item.completed" && event.item?.type === "agent_message" && event.item.text) {
+                answer = event.item.text;
+            }
+        }
+        catch {
+            // Keep parsing robust against non-JSON warnings or future event types.
+        }
+    }
+    return answer.trim();
+}
+function runCommand(command, args, stdin, timeoutMs, parse = (stdout) => stdout.trim()) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            stdio: ["pipe", "pipe", "pipe"],
+            env: process.env,
+        });
+        const timer = setTimeout(() => {
+            child.kill("SIGTERM");
+            reject(new Error(`Synthesis command timed out after ${timeoutMs}ms`));
+        }, timeoutMs);
+        const stdout = [];
+        const stderr = [];
+        child.stdout.on("data", (chunk) => stdout.push(chunk));
+        child.stderr.on("data", (chunk) => stderr.push(chunk));
+        child.on("error", (error) => {
+            clearTimeout(timer);
+            reject(error);
+        });
+        child.on("close", (code) => {
+            clearTimeout(timer);
+            if (code === 0) {
+                resolve(parse(Buffer.concat(stdout).toString("utf8")));
+                return;
+            }
+            reject(new Error(`PATHMARK_CHAT_COMMAND exited with code ${code}: ${Buffer.concat(stderr).toString("utf8").trim()}`));
+        });
+        child.stdin.end(stdin);
+    });
+}
+function runShellCommand(command, stdin, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, {
+            stdio: ["pipe", "pipe", "pipe"],
+            env: process.env,
+            shell: true,
+        });
+        const timer = setTimeout(() => {
+            child.kill("SIGTERM");
+            reject(new Error(`Synthesis command timed out after ${timeoutMs}ms`));
+        }, timeoutMs);
+        const stdout = [];
+        const stderr = [];
+        child.stdout.on("data", (chunk) => stdout.push(chunk));
+        child.stderr.on("data", (chunk) => stderr.push(chunk));
+        child.on("error", (error) => {
+            clearTimeout(timer);
+            reject(error);
+        });
+        child.on("close", (code) => {
+            clearTimeout(timer);
+            if (code === 0) {
+                resolve(Buffer.concat(stdout).toString("utf8").trim());
+                return;
+            }
+            reject(new Error(`PATHMARK_CHAT_COMMAND exited with code ${code}: ${Buffer.concat(stderr).toString("utf8").trim()}`));
+        });
+        child.stdin.end(stdin);
+    });
+}
+//# sourceMappingURL=chat.js.map

package/dist/chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.js","sourceRoot":"","sources":["../src/chat.ts"],"names":[],"mappings":"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"}

package/dist/codex/capture.d.ts

@@ -0,0 +1,12 @@
+export interface CodexHookInput {
+    cwd?: string;
+    session_id?: string;
+    prompt?: string;
+    transcript_path?: string;
+    tool_name?: string;
+    tool_input?: unknown;
+}
+export declare function recall(input: CodexHookInput): Promise<string>;
+export declare function prompt(input: CodexHookInput): Promise<string>;
+export declare function observe(input: CodexHookInput): Promise<string>;
+export declare function writeback(input: CodexHookInput): Promise<string>;