cursor

Cursor

gps gives Cursor durable, symbol-anchored repo memory. Because Cursor has no lifecycle hooks, the agent must call record_preference and record_directive MCP tools explicitly — the installed rule instructs the agent to do this automatically.

npx -y @invariance/gps setup --yes --with-cursor

Writes:

• .cursor/rules/gps.mdc — Cursor project rule with alwaysApply: true. Attached to every request without the agent having to discover it.
• .cursor/mcp.json — registers gps serve as an MCP server. Merged with any existing entries you already have.

What Cursor does with gps

The rule frontmatter:

---
description: gps — local repo memory (symbol graph, tests, invariants, lessons, decisions). Use the CLI before non-trivial edits.
alwaysApply: true
---

The body teaches the agent the standard gps calls and explains that Cursor has shell access — gps is a CLI, not a service. The MCP server in .cursor/mcp.json exposes the same surface as a tool set; the agent picks whichever fits.

Cursor doesn't expose pre/post-tool-use hooks. Index refresh happens lazily when gps prepare or gps context runs.

Explicit preference and directive capture (Cursor-specific)

Claude Code and Codex capture preferences and directives automatically via hooks. Cursor has no hooks, so the installed rule instructs the agent to call these MCP tools explicitly:

When the user gives a durable instruction ("from now on…", "always…", "i prefer…", "don't ever…") — call record_preference:

record_preference { "text": "<the user's instruction>" }

When the user gives a location-scoped instruction ("don't do X here", "always Y in this folder", "in the home page, avoid Z") — call record_directive:

record_directive { "text": "<instruction>", "area": "<directory or alias>" }

gps stores preferences in a managed block (global scope) and directives as area-scoped notes that resurface whenever you edit files in that directory. The installed .cursor/rules/gps.mdc reminds the agent to make these calls — no manual setup is needed beyond running gps setup --yes --with-cursor.