Skip to content

nehloo-interactive/graphnosis-cursor-plugin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Graphnosis — Cursor Plugin

Rules, skills, hooks, and slash commands for recall-first coding in Cursor.

Requires: Graphnosis desktop app (free tier works).

This plugin does not configure MCP. Wire Graphnosis tools via the in-app Configure Cursor wizard (see Setup below).


What's included

Component What it does
Rules Recall-first search, proactive save, skill-dispatch routing to trained SOPs
Skills session-start, bug-investigation, ship-workflow — thin wrappers that call MCP walk_skill_structured
Agent graphnosis-researcher — deep multi-engram memory synthesis
Commands /recall and /remember slash commands
Hook Session-end reminder to save durable context

MCP tools (recall, remember, edit, dig_deeper, skills, and more) come from the Graphnosis synapse — configured once in ~/.cursor/mcp.json by the desktop app, not by this plugin.


Setup

1. Install this plugin

Install from the Cursor plugin marketplace, or clone this repo and add it as a local plugin.

2. Connect MCP via Graphnosis (required)

  1. Open the Graphnosis app and unlock your cortex.
  2. Click the Cursor chip on the home screen (or go to Settings → AI Clients → Configure Cursor).
  3. Click Apply. Graphnosis writes ~/.cursor/mcp.json with the graphnosis-mcp-relay binary and socket path ~/.graphnosis/mcp.sock. Existing MCP servers are preserved.
  4. Developer: Reload Window in Cursor. Graphnosis tools appear in the MCP tools panel.

No bearer token, no env vars, no HTTP port — the relay talks to the same local synapse as every other MCP client.

Manual config and dev-build tips: Connect Your AI — Cursor.


Rules

graphnosis-skill-dispatch (always on)

At session start, calls list_skills + walk_skill_structured on skill-dispatch and runs matched trained SOPs from the graphnosis-skills engram (session-start, bug-investigation, ship-workflow, and more).

graphnosis-recall (always on)

Before answering any question about the user's projects, past decisions, preferences, or history — call recall first. Transforms queries (strip framing, match storage language, add synonyms), and escalates to dig_deeper when fewer than 4 nodes match.

graphnosis-save

Saves durable facts proactively — decisions, bug root causes, to-dos, deferred work. Uses check_duplicate before saving, and edit instead of remember when updating an existing memory.


Skills

Plugin skills are thin wrappers. When MCP is connected, they delegate to the canonical SOPs in the graphnosis-skills engram via walk_skill_structured.

session-start

Orients at the top of a session: recalls recent decisions, checks git status, surfaces open questions, confirms session focus. Orientation only — no code written.

bug-investigation

Recall-first bug loop: search past fixes → form hypothesis → apply minimal fix → run smoke test → loop max 4 times → save root cause to coding engram.

ship-workflow

Batch-commit SOP: show diff → wait for approval → group by concern → write real commit messages → security entries stay capability-level only → confirm before any tag or push.


Agent: graphnosis-researcher

A specialist agent for deep memory searches. Uses the recalldig_deeper escalation pattern, spans engrams with cross_search, and labels inferred overlay content ([gll·…], [gnn·…]) as predictions — never as attested facts.


Commands

Command What it does
/recall Search Graphnosis memory for selected text or a typed query
/remember Save selection or typed content to Graphnosis (checks for duplicates first)

Hook: session end

When a Cursor session ends, a brief reminder prompts you to save any durable decisions, bug findings, or open questions before closing.


What Graphnosis stores

Everything stays local and encrypted on your machine — Graphnosis never uploads your memory to any server. MCP tools operate over a local relay to ~/.graphnosis/mcp.sock. When you use Graphnosis from Cursor, memory is read/written locally; Cursor's AI sees only what you give it in context.


Engram routing

Graphnosis organizes memory into named engrams. Default routing for coding sessions:

What Engram
Code decisions, bug fixes, todos, session notes coding
Skills / SOPs graphnosis-skills
Architecture / infra decisions graphnosis-it-architecture
Business strategy, roadmap graphnosis-business-strategy

Pass target_engram to remember to route to a specific engram.


Links


Apache-2.0 License · © nehloo-interactive

About

Job memory and personal knowledge graph for Cursor. Recall memory before coding, save decisions as you work, run proven coding SOPs.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages