Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add instructions/holetexvn/memgw/agents-mdgit clone --depth 1 https://github.com/holetexvn/memgwWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/instructions/holetexvn/memgw/agents-md)<a href="https://agentmods.dev/instructions/holetexvn/memgw/agents-md"><img src="https://agentmods.dev/badge/instructions/holetexvn/memgw/agents-md.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00984 | $0.00984 |
| Opus 5 | $0.00492 | $0.00492 |
| Sonnet 5 | $0.00197 | $0.00197 |
| Haiku 4.5 | $0.00098 | $0.00098 |
Grade A, and why
memgw AGENTS.md scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Makes network callslowCapability
Not a fault in itself. Listed so you know the mod talks to something, and to what.
curl -sf http://127.0.0.1:8930/health # {"ok":true,...} How it starts
The opening of the file, as written. The whole thing — 70 lines — stays where its author put it; the contents beside it link to each section on GitHub.
memgw — instructions for AI agents
memgw is a shared long-term memory gateway for AI coding agents: one local store (SQLite + git) that Claude Code, Codex CLI, opencode, and any MCP client read from and write to. This file is for you, the agent, in two situations: installing memgw on your user's machine, or working on this codebase.
Installing memgw for your user
The wizard is non-interactive when stdin is not a TTY (or with --yes), so you can
run it directly:
npx @holetex/memgw setup --yes
What it does: creates ~/.memgw, generates auth keys, starts the gateway on
127.0.0.1:8930 (API) and :8931 (MCP), installs Claude Code hooks + MCP and Codex
MCP when those clients exist, and installs reboot supervision (launchd on macOS,
systemd --user on Linux; on Windows it prints the Task Scheduler command — run it).
Rules for you:
- The LLM key is the user's decision. Non-interactive setup skips the key, which
leaves memgw in capture-only mode — a safe default, nothing is lost: events queue
and get distilled retroactively once a key arrives. Tell the user this explicitly;
do not pressure them for a key. When they provide one:
(OpenAI, Anthropic, Groq, OpenRouter are recognised; the command also restarts the gateway so the key is live.) Never echo the key back, never commit it, never send it anywhere else.npx @holetex/memgw key "<key>" # provider auto-detected from the prefix - Verify, don't assume. After setup:
curl -sf http://127.0.0.1:8930/health # {"ok":true,...} npx @holetex/memgw doctor # every line should be ok (llm warns until a key is set) - Codex capture is a watcher process. Codex has no hooks. From a permanent
install on macOS/Linux,
setupinstalls the watcher supervised automatically (launchdcom.memgw.watch-codex/ systemdmemgw-watch-codex); on Windows or from the npx cache it prints the command — relay it to the user. Verify capture is really flowing withmemgw status("agents seen" must list a codex source after a Codex session). - Do not edit files under
~/.memgw/data/by hand — that is the memory store. Use the CLI (memgw save,memgw forget) or the MCP tools. - Per-client connection commands (opencode, claude.ai, Hermes, generic CLIs) are in docs/03-INTEGRATION.md; the setup wizard prints the ones it could not do automatically — relay those to the user instead of dropping them.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 4d ago First seen · 70 lines · 984 tokens per session scan A 2022c311da99
memgw AGENTS.md is an instructions file published in the GitHub repository holetexvn/memgw (4 stars, last pushed 22d ago), licensed MIT. It adds 984 tokens to every session, about $0.0049 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other instructions, from other repositories
activity-frames AGENTS.md
Instructions for nossa-y/activity-frames, covering can i install it without asking?, the mental model (10 seconds), fastest integration: mcp, from python and things you should not do.
plur CLAUDE.md
Claude Code instructions for plur-ai/plur, covering claude.md, what is plur, development, package dependency and version bumps.
honcho CLAUDE.md
Claude Code instructions for plastic-labs/honcho, covering claude.md, honcho overview, what is honcho?, core concepts and peer paradigm.
caura-cross-fleet-gov CLAUDE.md
Instructions for caura-ai/caura-cross-fleet-gov, covering claude.md, what this repo is, prerequisites, environment setup and gateway commands.
zer0dex AGENTS.md
Instructions for hermes-labs-ai/zer0dex, covering agents.md, use it for, do not use it for, minimal commands and output shape.
pgmnemo AGENTS.md
AGENTS.md instructions for pgmnemo/pgmnemo, covering pgmnemo — agent integration guide, 1. what pgmnemo is — and the problem it solves, the problem, architectural consequences and 2. when to adopt / when not to.