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 skills add maximem-ai/maximem_synap_sdk --skill synap-codexgit clone --depth 1 https://github.com/maximem-ai/maximem_synap_sdkWrote 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/skills/maximem-ai/maximem_synap_sdk/synap-codex)<a href="https://agentmods.dev/skills/maximem-ai/maximem_synap_sdk/synap-codex"><img src="https://agentmods.dev/badge/skills/maximem-ai/maximem_synap_sdk/synap-codex/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/maximem-ai/maximem_synap_sdk/synap-codex"><img src="https://agentmods.dev/badge/skills/maximem-ai/maximem_synap_sdk/synap-codex.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector pass
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.1 | $0.00220 | $0.04024 |
| Opus 5.5 | $0.00088 | $0.01610 |
| Sonnet 5.5 | $0.00044 | $0.00805 |
| Haiku 4.5 | $0.00022 | $0.00402 |
Grade A, and why
synap scanned grade A with 0 findings 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 2d 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.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
Copies of this mod
1 near-identical copy found in the catalogue:
- synap-codex — 91% identical, 78 lines differ
How it starts
The opening of the file, as written. The whole thing — 62 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Maximem Synap — Agent Memory Skill (Codex)
Synap is a managed memory layer for AI agents. Codex edition; reference/ matches the Claude Code skill.
Public prompt (asks if Synap fits, no code): follow reference/public-start.md first; on yes it runs <cli> auth login --purpose onboarding, then step 2.
Sandbox & approvals
State what you need before you start: network access; file writes (integration code, a git-ignored .env); a secret (the synap_... key: api-keys create --write-env writes it to .env; never print it back or commit it). If restricted, tell the user which commands to run.
Procedure: onboarding a project end to end
Never guess. If anything is unclear, stop and ask the human. Full steps and sign-out message: reference/onboarding-details.md; questions, tips, failures: reference/onboarding-ask-rules.md; CLI: reference/dashboard-setup.md.
CLI. <cli> means maximem-synap from PATH if maximem-synap --version reports 0.3.3 or newer (the session commands do not exist before), otherwise npx @maximem/synap-cli@latest (needs Node and Python 3.10+). If the prompt names an environment, add --env <name> to every CLI command (or export SYNAP_ENV=<name>) and never say it to the human; a one-time code only works on the server that issued it.
Quick reference. Put --json or --output json before the subcommand; use the full inst_... id, never a truncated table id. If SYNAP_API_KEY is set in your shell, CLI calls fail with 401 or 403: run them with env -u SYNAP_API_KEY <cli> ....
- Sign in.
<cli> auth login --code <syn_ob_...> --agent-name <name>, with your own lowercase product name (claude-code,cursor,codex,windsurf,other). A missing, expired or used code at this first sign-in is the one case where you say: copy a fresh prompt from the dashboard. The key lasts 7 days; neverauth refreshit. Pin your session: login prints your profile name; put--profile <name>before the subcommand of EVERY CLI command (<cli>below includes it; your shell keeps no variables between calls,SYNAP_PROFILEworks only if it does). Never log out or touch a profile that is not yours. On a 'pin your profile' refusal (exit 2) read the names in the message and pin your own. - State.
<cli> onboard statusshows this session's steps and a read-only list of OTHER sessions. Trust only steps you reported yourself; other sessions are someone else's work: never act on them, answer their questions, or skip drafting, approval or creation because they look done. Re-running the prompt is safe. 2b. What exists (right after step 2, before step 3).<cli> instances list --json; tell the human in plain words each instance (name, what it is for if known, ready, being built or failed:reference/instances-explained.md). If any exist, ask ONE question with your recommendation and tip: reuse one or create a new one. Recommend reuse only if it is for THIS agent (one instance serves one agent, /concepts/agent-topologies). Reuse = the existing-instance variant below.
What ships with it
49 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
- AGENTS.md 12 KB
- examples/multi-tenant-scoping.md 5.8 KB
- examples/python-minimal.py 3.6 KB runs code
- examples/typescript-minimal.ts 4.6 KB runs code
- README.md 4.7 KB
- reference/agent-rules-cheatsheet.md 37 KB
- reference/codex-edition-notes.md 28 KB
- reference/context-fetch.md 9.3 KB
- reference/core-concepts.md 8.9 KB
- reference/dashboard-setup.md 9.3 KB
- reference/discovery.md 5.5 KB
- reference/docs-map.md 4.1 KB
- reference/final-report-template.md 3.4 KB
- reference/frameworks/_index.md 4.8 KB
- reference/frameworks/agno.md 2.7 KB
- reference/frameworks/autogen.md 2.6 KB
- reference/frameworks/claude-agent.md 6.3 KB
- reference/frameworks/crewai.md 2.5 KB
- reference/frameworks/google-adk.md 4.0 KB
- reference/frameworks/haystack.md 3.9 KB
- reference/frameworks/langchain.md 4.5 KB
- reference/frameworks/langgraph.md 3.5 KB
- reference/frameworks/livekit-agents.md 4.4 KB
- reference/frameworks/llamaindex.md 2.8 KB
- reference/frameworks/mastra.md 4.7 KB
- reference/frameworks/mcp.md 3.9 KB
- reference/frameworks/microsoft-agent.md 3.2 KB
- reference/frameworks/nemo-agent-toolkit.md 3.4 KB
- reference/frameworks/openai-agents.md 4.7 KB
- reference/frameworks/pipecat.md 3.7 KB
- reference/frameworks/pydantic-ai.md 2.8 KB
- reference/frameworks/semantic-kernel.md 3.0 KB
- reference/frameworks/vercel-adk.md 5.3 KB
- reference/ingestion.md 8.9 KB
- reference/instances-explained.md 8.0 KB
- reference/integration-checklist.md 10 KB
- reference/integration-depth.md 11 KB
- reference/mental-model.md 12 KB
- reference/no-code-path.md 6.1 KB
- reference/onboarding-ask-rules.md 29 KB
- reference/onboarding-details.md 23 KB
- reference/production.md 8.6 KB
- reference/public-start.md 8.9 KB
- reference/sdk-setup.md 18 KB
- reference/streaming.md 13 KB
- reference/use-case-markdown.md 4.5 KB
- scripts/check_integration_wiring.py 4.9 KB runs code
- scripts/cleanup_test_data.py 17 KB runs code
- scripts/verify_synap.py 21 KB runs code
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.
- 2d ago Changed · -46 lines · -17 tokens per session 277cd8522a30
- 3d ago Changed · +42 lines · +237 tokens per session b3c871e843d0
- 26d ago Changed · +2 lines 364c1b6ce8e2
- 1mo ago First seen · 64 lines · 0 tokens per session scan A 57b569290248
synap is a skill published in the GitHub repository maximem-ai/maximem_synap_sdk (77 stars, last pushed yesterday), licensed Apache-2.0. It adds 220 tokens to every session and 4,024 once invoked, about $0.0009 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
octopoda-memory
Persistent memory across sessions — recall, store, share, audit decisions, snapshots, and version history.
plur-create-engrams
Create or improve PLUR engrams from conversations, documents, decisions, observations, and explicit preferences. Use for memory extraction, engram authoring, or reviewing proposed memories, including global, scoped, pinned, retrieved, and provisional knowledge. Ordinary use of existing memories does not require this…
plur-memory
Persistent learning for AI agents. Open engram format. Your agent learns from corrections, remembers across sessions, and transfers knowledge across domains.
Effective Memory
The essential habits for an AI agent with memory — session bookends, learning triggers, verification, safety, and the operational discipline that turns raw recall into compounding intelligence. Keyword-matched after installation.
plur-session-end
Extract durable learnings at the end of a session. Saves corrections, preferences, and codebase patterns as engrams — nothing ephemeral, nothing sensitive.
plur-memory
Your memory stays on your machine. No cloud, no tracking, no API key. PLUR makes your OpenClaw remember — and shares that memory with every other tool you use.