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 rules/supermemoryai/supermemory/docsgit clone --depth 1 https://github.com/supermemoryai/supermemoryWhat 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.00314 | $0.00314 |
| Opus 5 | $0.00157 | $0.00157 |
| Sonnet 5 | $0.00063 | $0.00063 |
| Haiku 4.5 | $0.00031 | $0.00031 |
Grade A, and why
docs 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 yesterday.
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 https://api.supermemory.ai/v3/endpoint \ What it actually says
Documentation MDX Format
All documentation files use MDX format with a specific structure:
Frontmatter
Every documentation file must begin with frontmatter:
---
title: "Page Title"
description: "Brief description of the page content"
icon: "icon-name" # Optional, uses Lucide icons
sidebarTitle: "Optional Sidebar Title" # Optional
---
Example: @features/query-rewriting.mdx
Components
Use the following components to enhance documentation:
Accordion
For collapsible sections:
<Accordion title="Section Title" defaultOpen icon="sparkles">
Content goes here...
</Accordion>
Example: @creation/supported-types.mdx
Notes and Warnings
For important information:
<Note>
Important information goes here.
</Note>
<Warning>
Critical warning goes here.
</Warning>
Example: @creation/adding-memories.mdx
Code Examples
For multi-language code examples:
<CodeGroup>
```bash cURL
curl https://api.supermemory.ai/v3/endpoint \
--header 'Authorization: Bearer SUPERMEMORY_API_KEY'
await client.method({
parameter: "value"
})
client.method(
parameter="value"
)
Example: @essentials/authentication.mdx
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.
- yesterday First seen · 85 lines · 314 tokens per session scan A 81ed1a255662
docs is a cursor rule published in the GitHub repository supermemoryai/supermemory (29,137 stars, last pushed 3d ago), licensed MIT. It adds 314 tokens to every session, about $0.0016 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-30.
Other cursor rules, from other repositories
ruler_cursor_instructions
1) Use the "ikas" MCP list tool to find the correct query/mutation name. 2) Use the "ikas" MCP introspect tool to get the operation's full shape (variables, return fields, enums). 3) Only after confirming via list + introspect, add the document to graphql-requests.ts and run codegen.
no-inline-imports
Keep imports at top of file and avoid inline imports.
testing
Ensure all tests pass before merging.
typescript-exhaustive-switch
Use exhaustive switch handling for TypeScript unions and enums.
git-workflow
Cloud Agents MUST run git add, git commit, and git push before ending their response when they have made code changes. Do not end your turn without pushing. ALWAYS use Pull Requests instead of pushing directly to main.
typescript-imports
Golden rule: import each symbol from the module that defines it. A package index.ts may barrel only its own ./ modules — never another package.