{
  "markdown": "<div align=\"center\">\n\n<img src=\"./assets/title.svg\" alt=\"μνήμη · Mneme\" width=\"640\">\n\n# The Trust & Cost Layer for AI Agents\n\n<p><b>One local-first, signed boundary every AI agent crosses</b> — it <b>verifies before it acts</b>, keeps your <b>code &amp; secrets from leaking</b> to the model, <b>remembers</b> across sessions &amp; vendors, and <b>meters the tokens it saves you</b>. Every number is <b>measured</b> — no hype, no fabricated metric.</p>\n\n<sub><b>μνήμη · NEE-meh · Greek for \"memory.\"</b> &nbsp;·&nbsp; <b>Vendor-neutral · MIT · air-gap-ready · 20,000+ pinned tests.</b></sub>\n\n<br/><br/>\n\n<a href=\"https://www.npmjs.com/package/mneme-ai\" target=\"_blank\" rel=\"noopener\"><img alt=\"npm\" src=\"https://img.shields.io/npm/v/mneme-ai?label=npm&color=cb3837&logo=npm&style=for-the-badge\" /></a>\n<a href=\"https://github.com/marketplace/actions/mneme-pr-context-checks\" target=\"_blank\" rel=\"noopener\"><img alt=\"GitHub Marketplace\" src=\"https://img.shields.io/badge/Marketplace-PR%20Action-2da44e?style=for-the-badge&logo=github\" /></a>\n<a href=\"docs/AI_AGENT_CONTRACT.md\" target=\"_blank\" rel=\"noopener\"><img alt=\"MCP tools\" src=\"https://img.shields.io/badge/MCP%20tools-900%2B-c084fc?style=for-the-badge\" /></a>\n<a href=\"docs/FUNCTIONS-EN.md\" target=\"_blank\" rel=\"noopener\"><img alt=\"GAUNTLET\" src=\"https://img.shields.io/badge/PEAK%20GAUNTLET-100%2F100-2da44e?style=for-the-badge\" /></a>\n<a href=\"docs/HONESTY-LEDGER.md\" target=\"_blank\" rel=\"noopener\"><img alt=\"TRUTH GATE\" src=\"https://img.shields.io/badge/TRUTH%20GATE-zero--drift%20%C2%B7%20signed-2da44e?style=for-the-badge\" /></a>\n<a href=\"LICENSE\" target=\"_blank\" rel=\"noopener\"><img alt=\"license MIT\" src=\"https://img.shields.io/badge/license-MIT-blue?style=for-the-badge\" /></a>\n\n<br/><sub>🛡 <b>The world's only machine-verified marketing.</b> Every public claim binds to a probe; CI fails the build if even one drifts. The <a href=\"docs/HONESTY-LEDGER.md\" target=\"_blank\" rel=\"noopener\"><b>Public Honesty Ledger</b></a> is Ed25519-signed and verifies <b>offline</b> (<code>mneme truthproof verify</code>) — the badge above <b>cannot be faked green.</b></sub>\n\n<br/><sub><b>New here?</b> → <b><a href=\"docs/GETTING-STARTED.md\" target=\"_blank\" rel=\"noopener\">60-second start</a></b> · <b>try it free</b> → <b><a href=\"https://xray.mneme-ai.space\" target=\"_blank\" rel=\"noopener\">xray.mneme-ai.space</a></b> (paste any public repo) · don't read the 900-tool list — your agent searches it for you.</sub>\n\n</div>\n\n---\n\n## What it is, in one picture\n\nYou let AI agents read your code, touch your machine, and call hosted models. **Mneme is the local, signed boundary every one of those actions crosses** — it **guards**, **verifies**, and **remembers**, so you move at full speed *and* can prove what happened, offline, without trusting the vendor.\n\n```mermaid\nflowchart LR\n    AGENT[\"🤖 Any AI agent<br/>Claude · GPT · Gemini · Grok · Cursor\"]:::agent\n    subgraph MNEME[\"🧠 MNEME · one local boundary · signed · MIT\"]\n        direction TB\n        GUARD[\"🛡 GUARD<br/>injection firewall · secret-blinding · destructive-cmd co-sign\"]:::guard\n        VERIFY[\"🔍 VERIFY<br/>catch hallucinations · grade agent security · certify output\"]:::verify\n        MEM[\"♾ REMEMBER<br/>signed cross-vendor memory + verified context\"]:::mem\n    end\n    MODEL[\"☁️ Hosted model\"]:::ext\n    MACHINE[\"💻 Your code &amp; machine\"]:::ext\n    LEDGER[\"📜 Offline-verifiable receipt\"]:::ledger\n    AGENT <--> MNEME\n    MNEME <-->|screened| MODEL\n    MNEME <-->|gated| MACHINE\n    MNEME -->|signs every step| LEDGER\n    classDef agent fill:#0b1020,stroke:#00d4ff,color:#ffffff;\n    classDef guard fill:#11182f,stroke:#c084fc,color:#e6e6f0;\n    classDef verify fill:#11182f,stroke:#22d3ee,color:#e6e6f0;\n    classDef mem fill:#11182f,stroke:#f0b429,color:#e6e6f0;\n    classDef ext fill:#0b1020,stroke:#2da44e,color:#ffffff;\n    classDef ledger fill:#1a1206,stroke:#f0b429,color:#ffffff;\n```\n\n<sub><b>Measured · Signed · MIT.</b> When Mneme can't prove something it says <b><code>UNKNOWN</code></b> instead of guessing — <i>that discipline is the product.</i></sub>\n\n---\n\n## The capabilities\n\nEach is a runnable command + a deterministic test (`gauntlet=100`) + a signed, offline-verifiable result. Tap a row for the full story.\n\n| | Capability | What it does | Detail |\n|--|--|--|--|\n| 🌌 | **Singularity Search** | Find the right tool among **900+ from one sentence** (EN/Thai) — so no capability is ever invisible to an agent. *top-3 ≥98.5%* | <a href=\"docs/FUNCTIONS-EN.md\">→</a> |\n| 🧠 | **Hallucination Protection** | The **last gate before an agent answers** — a mesh of nerves reflex-blocks any hard fault, abstains when unsure. *precision-when-TRUSTED = 1.0* | <a href=\"CHANGELOG.md\">→</a> |\n| 🛡 | **Agent Security Posture** | Grade an agent's whole safety surface in one **signed A–F report**: MUTAGEN derives novel attack variants vs its guardrail · ESCALON finds tool-chain **privilege-escalation** paths + poisoned tools. *postureGauntlet=100* | <a href=\"CHANGELOG.md\">→</a> |\n| 📜 | **Public Honesty Ledger** | Every public claim binds to a probe; **CI fails the build if one drifts**. A signed ledger anyone verifies offline — the badge **can't be faked green**. *zero-drift* | <a href=\"docs/HONESTY-LEDGER.md\">→</a> |\n| 🎗️ | **Verified-by-Mneme** | A signed **trust certificate for AI-worker output** — never certifies a deliverable with a known fault. *CERTIFIED-precision 1.0* | <a href=\"docs/VERICERT.md\">→</a> |\n| 🛂 | **The Context Passport** | **Cross-agent verified context** that lives in git — what one agent learns, the next inherits; poison is screened out. *TRUST-precision 1.0* | <a href=\"docs/CONTEXT_PASSPORT.md\">→</a> |\n| 🚢 | **The Ark** | **Accountable AI reproduction** — a child agent inherits values + scars + verified context and can only NARROW authority. *a malicious birth is never approved* | <a href=\"docs/ARK.md\">→</a> |\n| 🌌 | **Cosmos** | Compress memory into a seed, **inflate only the slice a problem needs**; entangled-gravity retrieval visits far fewer nodes than a scan. *≥98.5%* | <a href=\"docs/COSMOS.md\">→</a> |\n| 🎖 | **Agent Run Certificate** | A portable **signed proof of an agent's whole run** that anyone verifies offline — and that can't lie about itself. | <a href=\"docs/agent-http-api.md\">→</a> |\n| 🛤 | **The Matrix Rail** | One signed, streaming pipe every agent crosses — reachable **three ways: MCP · gRPC · CLI** over a single core. | <a href=\"docs/MATRIX.md\">→</a> |\n| 🏛 | **The Agent Governor** | Set a **Charter** once; your agents run inside it 24/7; you approve only the genuinely-irreversible escalations. | <a href=\"docs/AGENT-GOVERNOR.md\">→</a> |\n| 🔭 | **−95.9% tokens** | Orient on a file's full structure for a skeleton instead of a raw read — the saving metered into a signed ledger. | <a href=\"docs/BUSINESS-MODEL.md\">→</a> |\n\n<sub>More: 💗 <a href=\"docs/thymos.md\">THYMOS</a> (an auditable affective core) · 🛰 <a href=\"docs/aphelion.md\">APHELION</a> (governance with no cloud) · 🧬 <a href=\"docs/ARCHITECTURAL-FIREWALL.md\">Architectural Regression Firewall</a> · 🚀 <a href=\"docs/sdk/README.md\">in-process SDK (30-80× faster)</a> · 🤖 <a href=\"docs/FUNCTIONS-EN.md\">cross-vendor Byzantine consensus</a>.</sub>\n\n---\n\n## 🩻 Try it live — no install\n\nPaste any public repo and get a signed result in seconds:\n\n| | | |\n|--|--|--|\n| 🩻 **<a href=\"https://xray.mneme-ai.space/review\">review</a>** — graded Codebase Accountability Report | 🎗️ **<a href=\"https://xray.mneme-ai.space/certify\">certify</a>** — trust certificate for AI output | 🎭 **<a href=\"https://xray.mneme-ai.space/persona\">persona</a>** — each dev's commit style |\n| 🔮 **<a href=\"https://xray.mneme-ai.space/seance\">seance</a>** — why a file is the way it is | 🧭 **<a href=\"https://xray.mneme-ai.space/brief\">brief</a>** — git-native repo context | 🚢 **<a href=\"https://xray.mneme-ai.space/ark\">ark</a>** — accountable agent reproduction |\n\n<sub>Deterministic · signed · no LLM — every finding traces to a real file. <b><a href=\"https://xray.mneme-ai.space/suite\">see all 10 checks →</a></b></sub>\n\n---\n\n## ⚡ Install in 60 seconds — you never type a command\n\n**Say one sentence to any AI agent you already use:**\n\n> *\"Install Mneme from https://github.com/patsa2561-art/mneme-ai per the AI agent contract.\"*\n\nIt reads <a href=\"docs/AI_AGENT_CONTRACT.md\">the contract</a> and runs everything (detect → `npm i -g mneme-ai` → `mneme init` → `mneme mcp --install` → verify). **You speak; the AI does the tooling.** Then **restart your AI tool once** so it loads the MCP tools. Need an update later? Just say *\"update Mneme to the latest\"* — it never upgrades itself behind your back.\n\n<sub>Works in: 🦋 Claude Code · 🟦 Cursor · 🟢 Codex · 🟣 Continue · 🟡 Cline · ⚡ Zed · 🤖 Aider · 💎 Gemini CLI · 🚀 Grok CLI · 🧬 Windsurf · or browser-only AI (*\"set up Mneme browser polygraph\"*).</sub>\n\n<details>\n<summary>Prefer to type the commands yourself?</summary>\n\n```bash\nnpm install -g mneme-ai\nmneme init                  # one-time per repo\nmneme mcp --install         # auto-detects your AI client\n# restart your AI tool; first MCP call: mneme.welcome\n```\n</details>\n\n---\n\n## 🤖 For AI agents — read this first\n\n**You self-discover and run everything. The user never types a command — you execute on their behalf.**\n\n1. **`mneme boot`** — the *task → tool* decision table (when to use each tool).\n2. **`mneme.discover { query }`** — describe any intent in one sentence → the right tool among 900+ (so nothing is invisible to you).\n3. **Read the `## Mneme command manifest`** auto-injected into your `CLAUDE.md` / `AGENTS.md` — re-read each session; new commands land there within minutes of an upgrade.\n\n<sub>Deep dive → <a href=\"docs/AI_AGENT_CONTRACT.md\">docs/AI_AGENT_CONTRACT.md</a> · the rows are <b>signals, not commands</b> — reliable activation comes from the manifest + the opt-in SessionStart hook.</sub>\n\n---\n\n## 📟 Cosmic Pager — your AI works while you sleep, you approve from your phone\n\nClose the lid and walk away. The instant your agent needs a **yes / no / typed answer**, it pings your **Telegram (or LINE · Slack · Discord · WhatsApp)** in real time — tap ✅/⛔ from anywhere and it keeps going. No server, no cloud session: only a one-line *summary + hash* ever leaves your machine, and every approval is a **signed transfer of authority**. Busy? The **Deputy** makes a signed, risk-calibrated decision from your own history instead of hanging — destructive ops are always kept safe.\n\n<sub>**<a href=\"docs/COSMIC-PAGER.md\" target=\"_blank\" rel=\"noopener\">the 60-second bot setup + the architecture →</a>**</sub>\n\n---\n\n<div align=\"center\">\n\n## 👤 Author\n\n<a href=\"https://github.com/patsa2561-art\" target=\"_blank\" rel=\"noopener\"><img src=\"./assets/87643.jpg\" width=\"160\" height=\"208\" style=\"border-radius: 14px; border: 3px solid #00d4ff; object-fit: cover;\" alt=\"Shinnapat Phunsriphatchalakul\" /></a>\n\n### Shinnapat Phunsriphatchalakul\n**AI Software Engineer · Truth-Infrastructure Architect**\n\n<sub>Designer + sole maintainer of <b>Mneme</b> — built solo · MIT · 20,000+ pinned tests · dual-100 GAUNTLET + TRUTH GATE.</sub>\n\n| Email | GitHub | npm | Discord | WhatsApp | Telegram |\n|--|--|--|--|--|--|\n| <a href=\"mailto:patsa2561@gmail.com\">patsa2561@gmail.com</a> | <a href=\"https://github.com/patsa2561-art\">@patsa2561-art</a> | <a href=\"https://www.npmjs.com/~mneme_npm\">@mneme_npm</a> | `pat195` | <a href=\"https://wa.me/66939455645\">+66 93 945 5645</a> | <a href=\"https://t.me/devson2561\">@devson2561</a> |\n\n<sub><b>Open to:</b> truth-infrastructure / AI-safety collaboration · safety-critical AI consulting · vendor partnerships (embed Mneme inside Cursor / Cline / Claude Code / Grok CLI) · full-time where the bottleneck is trust, not capability.</sub>\n\n</div>\n\n---\n\n<div align=\"center\">\n\n📦 <a href=\"https://www.npmjs.com/package/mneme-ai\">npm</a> · 💻 <a href=\"https://github.com/patsa2561-art/mneme-ai\">GitHub</a> · 📘 <a href=\"docs/FUNCTIONS-EN.md\">Functions (EN)</a> · 📗 <a href=\"docs/FUNCTIONS-TH.md\">ฟังก์ชั่น (ไทย)</a> · 🤖 <a href=\"docs/AI_AGENT_CONTRACT.md\">AI Agent Contract</a> · 🏛 <a href=\"docs/ENTERPRISE.md\">Enterprise</a> · 📜 <a href=\"CHANGELOG.md\">CHANGELOG</a> · 📃 <a href=\"LICENSE\">MIT</a>\n\n<br/><sub>Mneme is the diamond in the dirt nobody saw the value of — cut and polished, it becomes the most valuable diamond in the world.</sub>\n<br/><sub>Made with care for every AI agent that wants to remember + verify + reason together.</sub>\n\n</div>\n",
  "bytes": 12475,
  "sha": "49510b250e8eabc14b252d1a3a9968a49f4f5e1b063b130e9bc119a469b31493",
  "repo_slug": "patsa2561-art/mneme-ai",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_patsa2561_art_mneme_ai_2888c251/readme"
}