Borrowing it
Nothing to install: this file belongs to putervision/state-memory-mcp. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/putervision/state-memory-mcp/main/.windsurfrulesgit clone --depth 1 https://github.com/putervision/state-memory-mcpWrote 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/rules/putervision/state-memory-mcp/windsurfrules)<a href="https://agentmods.dev/rules/putervision/state-memory-mcp/windsurfrules"><img src="https://agentmods.dev/badge/rules/putervision/state-memory-mcp/windsurfrules/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/rules/putervision/state-memory-mcp/windsurfrules"><img src="https://agentmods.dev/badge/rules/putervision/state-memory-mcp/windsurfrules.svg" alt="Reviewed on agentmods" width="80" 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.1 | $0.24727 | $0.24727 |
| Opus 5.5 | $0.09891 | $0.09891 |
| Sonnet 5.5 | $0.04945 | $0.04945 |
| Haiku 4.5 | $0.02473 | $0.02473 |
Grade B, and why
windsurfrules scanned grade B 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 1mo 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.
Reads agent configuration directoriesmediumAgent snooping
.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.
* **Google Antigravity (`~/.gemini/config/config.json`)**: Add these rules to your `"globalPermissionGrants"` -> `"allow"` list: How it starts
The opening of the file, as written. The whole thing — 1,047 lines — stays where its author put it; the contents beside it link to each section on GitHub.
State Memory (state-memory-mcp)
This project tracks workflow state, tasks, design decisions, and blockers using state-memory-mcp with project slug "state-memory-mcp".
1. Priority Order
Before doing any coding or investigation:
manage_sessions(action: "start")— Start a tracking session for full change attribution.get_analytics(action: "summary")— Run to understand current project state, active branches, and overall progress.manage_tasks(action: "next")— Query prioritized runnable tasks.manage_tasks(action: "find_blockers")— Identify any active blockers preventing progress.manage_nodes(action: "list")— Find pending tasks, past decisions, or milestones.query_graph(action: "trace")— Trace what depends on or blocks a task.
2. When to Write to the Graph
You MUST update the graph as you work:
- Starting a session: Always call
manage_sessions(action: "start", agent_id: "my-agent")to track all mutations under a unique session. - Starting a new task: Create a node with
manage_nodes(action: "create", type: "task", title: "...", session_id: session_id). - Making a design or implementation decision: Document it with
manage_nodes(action: "create", type: "decision", title: "...", metadata: { "rationale": "..." }, session_id: session_id). - Encountering a blocker: Record the blocker with
manage_nodes(action: "create", type: "blocker", ..., session_id: session_id)and connect it usingmanage_edges(action: "add", type: "blocks", source_id: blocker_id, target_id: task_id, session_id: session_id). - Adding observation notes: Atomically log notes using
manage_nodes(action: "add_note", text: "...", attach_to: node_id). - Batch updates: Bulk update tasks/nodes using
manage_nodes(action: "batch_update", ids: ["..."], status: "done"). - Completing a task: Update status to done using
manage_tasks(action: "complete", task_id: task_id). - Creating/generating a new file: Create an artifact node with
manage_nodes(action: "create", type: "artifact", ..., session_id: session_id)and connect it usingmanage_edges(action: "add", type: "produces", ..., session_id: session_id).
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.
- 1mo ago Changed · +216 lines · +5,298 tokens per session 211d6d39d8a4
- 1mo ago Changed · +221 lines · +5,406 tokens per session 2b24d11fb8fb
- 1mo ago Changed · +396 lines · +9,713 tokens per session 5682ff964771
- 1mo ago First seen · 214 lines · 4,310 tokens per session scan B a4040277c15a
windsurfrules is a cursor rule published in the GitHub repository putervision/state-memory-mcp (42 stars, last pushed 1mo ago), licensed MIT. It adds 24,727 tokens to every session, about $0.0989 per session on Opus 5.5. A static security scan graded it B with 1 finding (reads agent configuration directories). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-11.
windsurfrules compared with cursor rules from other repositories
| Mod | Type | Stars | Last push | Licence | Scan | Tokens | Works with |
|---|---|---|---|---|---|---|---|
| windsurfrulesputervision/state-memory-mcp | Cursor rule | 42 | 1mo ago | MIT | B | 24,727 | Windsurf |
| misakanet-failure-memoryIkalus1988/MisakaNet | Cursor rule | 554 | today | Apache-2.0 | A | 0 | Cursor |
| synapsemyelixlabs/synapse-mcp | Cursor rule | 7 | 1mo ago | MIT | A | 323 | Cursor |
| ponytailDietrichGebert/ponytail | Cursor rule | 185k | 8d ago | MIT | A | 604 | Cursor |
| angular-20angular/angular | Cursor rule | 101k | yesterday | MIT | A | 0 | Cursor |
| dev-standardapache/superset | Cursor rule | 75k | today | Apache-2.0 | A | 1,147 | Cursor |
| prefer-direct-imports-over-module-mocksprisma/orm | Cursor rule | 48k | yesterday | Apache-2.0 | A | 0 | Cursor |