Skip to content

Commit a95738f

Browse files
committed
docs(readme): fix stale duplicate proxy blurb, drop leaked project name
Verification pass requested by user across: the 5-problems table, Architecture diagram, Positioning section, MCP Plug & Play, and Universal Architecture/escape-hatches section. Verified accurate, no changes needed: - Architecture diagram (daemon endpoints /api/god/poll, /api/god/agents, CrossEncoderReranker, INT8 quantization, Ebbinghaus decay) -- all confirmed present in mathir_lib/*.py. - Console Scripts table -- matches pyproject.toml's [project.scripts] exactly (6/6 entries). - Positioning section's external claims -- researched live: Claude Chat Memory (all plans, March 2026), ChatGPT "Dreaming" (June 2026), and Gemini's Personal Intelligence/"memories" are real and dated within 2026 as claimed. Mem0/Zep-Graphiti/Letta/Cognee/LangMem are all real, actively-compared 2026 frameworks; the LongMemEval numbers cited (Zep/Graphiti 63.8%, Mem0 49.0%) are real and published. MATHIR's own cited LoCoMo numbers (51.2%, 38.8%) and anomaly-eval corpus both exist and match benchmarks/06_results/current/README.md exactly. - AGENTS.md / agents.md claim -- verified real: Linux-Foundation-adjacent open standard, 60,000+ projects as of Dec 2025, tool list matches confirmed adopters (Aider, VS Code, Zed, Warp, Roo Code, Jules, JetBrains Junie, Factory, OpenCode, GitHub Copilot). Found and fixed: - The "Universal escape hatches" list's item #1 was a stale, word-for- word duplicate of the Tier C table row directly above it -- except it still said "OpenAI-compatible" only with a single `OPENAI_BASE_URL` example, contradicting the Tier C row's already-fixed Anthropic + OpenAI-compatible description two lines up. Removed the redundant restatement entirely (Tier C already covers it correctly); kept the AGENTS.md item, which is genuinely distinct info. - The per-project DB routing example used a specific unrelated project's name ("Mycerise_V2_Taur") as if it were part of MATHIR's own structure -- replaced with a generic `your-project/` placeholder. Synced to ~/.config/MATHIR/README.md.
1 parent 59c9bd2 commit a95738f

1 file changed

Lines changed: 5 additions & 12 deletions

File tree

README.md

Lines changed: 5 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -200,20 +200,13 @@ MATHIR has **2 long-running processes** + **1 cross-tool instruction file**:
200200
| **B — Instructions + MCP** | MCP server registered + `GLOBAL_INSTRUCTIONS.md` injected. Agent must follow the advisory instruction to call `memory_session_start`**or upgrade to the proxy below for a hard guarantee (v8.9.4+)** | claude-code, cursor, cline, zcode, codex, etc. (14 agents) | SOFT — agent must comply, unless proxied |
201201
| **C — Universal proxy** | Point `ANTHROPIC_BASE_URL` or `OPENAI_BASE_URL` at the proxy (port 7339) — no MCP, no agent cooperation, works identically for every tool pointed at it | Any tool with a custom-base-URL setting: windsurf, gemini-cli, kilo, qwen, kiro-ide, warp, trae, crush, claude-code, codex, local models (Ollama/llama.cpp), etc. | HARD — set `ANTHROPIC_BASE_URL=http://127.0.0.1:7339` for Anthropic-native tools (no `/v1` — matches the Anthropic SDK's own base-URL convention), or `OPENAI_BASE_URL=http://127.0.0.1:7339/v1` for OpenAI-compatible tools (`/v1` required — matches the OpenAI SDK's default) |
202202

203-
**Universal escape hatches** (escape from tier C → true auto-inject):
204-
205-
1. **`mathir-proxy` on port 7339** — OpenAI-compatible LLM proxy. Intercepts every `/v1/chat/completions`, queries daemon `/api/context`, prepends `<mathir-auto-injection>` block to system prompt. **Works for ANY agent that redirects its baseUrl**.
206-
```bash
207-
export OPENAI_BASE_URL=http://127.0.0.1:7339/v1
208-
```
209-
210-
2. **`AGENTS.md` at repo root** — read automatically by 26+ agents (Aider, Amp, Claude Code, Codex, Cursor, Devin, Factory, Goose, JetBrains Junie, Jules, OpenCode, VS Code Copilot, Warp, Zed, etc. — see [agents.md](https://agents.md)). Instructs the agent to call `memory_session_start` on first turn + `memory_context` before each task.
211-
```bash
212-
cp mathir_mcp/opencode_templates/AGENTS.md /path/to/your/project/AGENTS.md
213-
```
203+
**Additional escape hatch — `AGENTS.md` at your project root:** read automatically by 26+ agents (Aider, Amp, Claude Code, Codex, Cursor, Devin, Factory, Goose, JetBrains Junie, Jules, OpenCode, VS Code Copilot, Warp, Zed, etc. — real open standard, [agents.md](https://agents.md), 60,000+ projects as of Dec 2025). Instructs the agent to call `memory_session_start` on first turn + `memory_context` before each task — a soft guarantee like tier B, but works even for agents not in the tier table above.
204+
```bash
205+
cp mathir_mcp/opencode_templates/AGENTS.md /path/to/your/project/AGENTS.md
206+
```
214207

215208
**Per-project DB routing** — each project gets its own `.mathir/mathir.db`:
216-
- Mycerise_V2_Taur`Mycerise_V2_Taur/.mathir/mathir.db`
209+
- `your-project/``your-project/.mathir/mathir.db`
217210
- mathir_mcp (installer) → `~/.config/MATHIR/mathir_mcp/.mathir/mathir.db`
218211
- Future projects → `<project>/.mathir/mathir.db` (auto-created on first save)
219212

0 commit comments

Comments
 (0)