Skip to content

patsa2561-art/mneme-ai

Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,175 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

μνήμη · Mneme

The Trust & Cost Layer for AI Agents

One local-first, signed boundary every AI agent crosses — it verifies before it acts, keeps your code & secrets from leaking to the model, remembers across sessions & vendors, and meters the tokens it saves you. Every number is measured — no hype, no fabricated metric.

μνήμη · NEE-meh · Greek for "memory."  ·  Vendor-neutral · MIT · air-gap-ready · 20,000+ pinned tests.



npm GitHub Marketplace MCP tools GAUNTLET TRUTH GATE license MIT


🛡 The world's only machine-verified marketing. Every public claim binds to a probe; CI fails the build if even one drifts. The Public Honesty Ledger is Ed25519-signed and verifies offline (mneme truthproof verify) — the badge above cannot be faked green.


New here?60-second start · try it freexray.mneme-ai.space (paste any public repo) · don't read the 900-tool list — your agent searches it for you.


What it is, in one picture

You 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.

flowchart LR
    AGENT["🤖 Any AI agent<br/>Claude · GPT · Gemini · Grok · Cursor"]:::agent
    subgraph MNEME["🧠 MNEME · one local boundary · signed · MIT"]
        direction TB
        GUARD["🛡 GUARD<br/>injection firewall · secret-blinding · destructive-cmd co-sign"]:::guard
        VERIFY["🔍 VERIFY<br/>catch hallucinations · grade agent security · certify output"]:::verify
        MEM["♾ REMEMBER<br/>signed cross-vendor memory + verified context"]:::mem
    end
    MODEL["☁️ Hosted model"]:::ext
    MACHINE["💻 Your code &amp; machine"]:::ext
    LEDGER["📜 Offline-verifiable receipt"]:::ledger
    AGENT <--> MNEME
    MNEME <-->|screened| MODEL
    MNEME <-->|gated| MACHINE
    MNEME -->|signs every step| LEDGER
    classDef agent fill:#0b1020,stroke:#00d4ff,color:#ffffff;
    classDef guard fill:#11182f,stroke:#c084fc,color:#e6e6f0;
    classDef verify fill:#11182f,stroke:#22d3ee,color:#e6e6f0;
    classDef mem fill:#11182f,stroke:#f0b429,color:#e6e6f0;
    classDef ext fill:#0b1020,stroke:#2da44e,color:#ffffff;
    classDef ledger fill:#1a1206,stroke:#f0b429,color:#ffffff;
Loading

Measured · Signed · MIT. When Mneme can't prove something it says UNKNOWN instead of guessing — that discipline is the product.


The capabilities

Each is a runnable command + a deterministic test (gauntlet=100) + a signed, offline-verifiable result. Tap a row for the full story.

Capability What it does Detail
🌌 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%
🧠 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
🛡 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
📜 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
🎗️ Verified-by-Mneme A signed trust certificate for AI-worker output — never certifies a deliverable with a known fault. CERTIFIED-precision 1.0
🛂 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
🚢 The Ark Accountable AI reproduction — a child agent inherits values + scars + verified context and can only NARROW authority. a malicious birth is never approved
🌌 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%
🎖 Agent Run Certificate A portable signed proof of an agent's whole run that anyone verifies offline — and that can't lie about itself.
🛤 The Matrix Rail One signed, streaming pipe every agent crosses — reachable three ways: MCP · gRPC · CLI over a single core.
🏛 The Agent Governor Set a Charter once; your agents run inside it 24/7; you approve only the genuinely-irreversible escalations.
🔭 −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.

More: 💗 THYMOS (an auditable affective core) · 🛰 APHELION (governance with no cloud) · 🧬 Architectural Regression Firewall · 🚀 in-process SDK (30-80× faster) · 🤖 cross-vendor Byzantine consensus.


🩻 Try it live — no install

Paste any public repo and get a signed result in seconds:

🩻 review — graded Codebase Accountability Report 🎗️ certify — trust certificate for AI output 🎭 persona — each dev's commit style
🔮 seance — why a file is the way it is 🧭 brief — git-native repo context 🚢 ark — accountable agent reproduction

Deterministic · signed · no LLM — every finding traces to a real file. see all 10 checks →


⚡ Install in 60 seconds — you never type a command

Say one sentence to any AI agent you already use:

"Install Mneme from https://github.com/patsa2561-art/mneme-ai per the AI agent contract."

It reads the contract and runs everything (detect → npm i -g mneme-aimneme initmneme 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.

Works in: 🦋 Claude Code · 🟦 Cursor · 🟢 Codex · 🟣 Continue · 🟡 Cline · ⚡ Zed · 🤖 Aider · 💎 Gemini CLI · 🚀 Grok CLI · 🧬 Windsurf · or browser-only AI ("set up Mneme browser polygraph").

Prefer to type the commands yourself?
npm install -g mneme-ai
mneme init                  # one-time per repo
mneme mcp --install         # auto-detects your AI client
# restart your AI tool; first MCP call: mneme.welcome

🤖 For AI agents — read this first

You self-discover and run everything. The user never types a command — you execute on their behalf.

  1. mneme boot — the task → tool decision table (when to use each tool).
  2. mneme.discover { query } — describe any intent in one sentence → the right tool among 900+ (so nothing is invisible to you).
  3. 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.

Deep dive → docs/AI_AGENT_CONTRACT.md · the rows are signals, not commands — reliable activation comes from the manifest + the opt-in SessionStart hook.


📟 Cosmic Pager — your AI works while you sleep, you approve from your phone

Close 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.

the 60-second bot setup + the architecture →


👤 Author

Shinnapat Phunsriphatchalakul

Shinnapat Phunsriphatchalakul

AI Software Engineer · Truth-Infrastructure Architect

Designer + sole maintainer of Mneme — built solo · MIT · 20,000+ pinned tests · dual-100 GAUNTLET + TRUTH GATE.

Email GitHub npm Discord WhatsApp Telegram
patsa2561@gmail.com @patsa2561-art @mneme_npm pat195 +66 93 945 5645 @devson2561

Open to: 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.


📦 npm · 💻 GitHub · 📘 Functions (EN) · 📗 ฟังก์ชั่น (ไทย) · 🤖 AI Agent Contract · 🏛 Enterprise · 📜 CHANGELOG · 📃 MIT


Mneme is the diamond in the dirt nobody saw the value of — cut and polished, it becomes the most valuable diamond in the world.
Made with care for every AI agent that wants to remember + verify + reason together.