memex: Cursor rule for Cursor

.cursorrules

cursorrules is a cursor rule for Cursor from iamtouchskyer/memex. It costs 1,610 tokens per session, scanned A, original, MIT.

A set of working rules for Memex, a memory system that stores linked notes in Markdown files for AI agents.

In plain words
What is it for?
It helps developers work on note storage, search, command-line commands, server operations, and the boundaries between those parts.
Why use it?
It keeps the project’s memory, command-line interface, and server code organized so changes go in the right layer and existing tests remain the guide.

Cursor rule for Cursor

Written for Cursor: installed under .cursor/. Also seen: mentions .claude-plugin; mentions Claude Code.

This is iamtouchskyer/memex's own configuration. It tells Cursor how to work on memex itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything memex configures →

Reuse

Borrowing it

Nothing to install: this file belongs to iamtouchskyer/memex. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/iamtouchskyer/memex/main/.cursorrules
Clone the repo
git clone --depth 1 https://github.com/iamtouchskyer/memex

Made for: Cursor.

Wrote 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.

agentmods badge for cursorrules

README.md
[![agentmods](https://agentmods.dev/badge/rules/iamtouchskyer/memex/cursorrules/github.svg)](https://agentmods.dev/rules/iamtouchskyer/memex/cursorrules)
Your own site
<a href="https://agentmods.dev/rules/iamtouchskyer/memex/cursorrules"><img src="https://agentmods.dev/badge/rules/iamtouchskyer/memex/cursorrules/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.

agentmods 80×15 button for cursorrules

Your own site · 80×15
<a href="https://agentmods.dev/rules/iamtouchskyer/memex/cursorrules"><img src="https://agentmods.dev/badge/rules/iamtouchskyer/memex/cursorrules.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 1,610 This file is loaded in full into every session.
When invoked 1,610 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

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.

ModelPer sessionOnce invoked
Fable 5.1 $0.01610 $0.01610
Opus 5.5 $0.00644 $0.00644
Sonnet 5.5 $0.00322 $0.00322
Haiku 4.5 $0.00161 $0.00161

Measured 1mo ago against content hash 7851fffd5a91, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

cursorrules 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 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.

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.

Origin

Copies of this mod

1 near-identical copy found in the catalogue:

.cursorrules · 132 lines

How it starts

The opening of the file, as written. The whole thing — 132 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Memex — Agent Working Instructions

Detailed architecture reference: docs/ARCHITECTURE.md

What Is This

Zettelkasten memory for AI agents. Markdown cards in ~/.memex/cards/ with [[wikilinks]]. npm package @touchskyer/memex. Distributed as CLI + MCP server + Claude Code plugin + VS Code extension + Pi extension.

Before You Touch Anything

npm test          # must pass. vitest, 70% coverage threshold.

Build has a known TS error (node-llama-cpp optional dep). Ignore it — it compiles fine for distribution.

How The Code Is Layered

MCP tools (src/mcp/)  →  Commands (src/commands/)  →  Lib (src/lib/)  →  Filesystem (~/.memex/)
     ↑ client-facing         ↑ business logic           ↑ data access

The rule: MCP tools and CLI are thin wrappers. All logic lives in src/commands/. All data access in src/lib/store.ts. Don't put logic in the wrong layer.

Files You'll Actually Need

When you're changing... Read these first
Card read/write/slug behavior src/lib/store.ts (164 lines — read all of it)
MCP tool behavior src/mcp/operations.ts (high-level), src/mcp/server.ts (low-level)
Search (keyword or semantic) src/commands/search.ts (most complex file, ~390 lines)
Sync / git operations src/lib/sync.ts (GitAdapter, autoSync, autoFetch)
Embeddings src/lib/embeddings.ts (3 providers + cache)
Card parsing / frontmatter src/lib/parser.ts (47 lines — tiny but critical)
Organize / graph analysis src/commands/organize.ts
Claude Code plugin hooks hooks/hooks.json
VS Code extension vscode-extension/src/extension.ts
Pi extension pi-extension/index.ts

Do / Don't

DO

  • Keep commands pure: return {output, exitCode} or {success, content/error}. Let CLI/MCP handle I/O.
  • Use .js extensions in all imports (Node16 ESM resolution).
  • Test both nestedSlugs: false (default) and nestedSlugs: true when touching store.ts.
  • Run npm test before declaring anything done.
  • Add new MCP tools in operations.ts if they need hooks, in server.ts if they don't.
  • Use zod for MCP tool input schemas (already imported in both MCP files).

Read the full file on GitHub · 132 lines

Changes

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.

  1. 1mo ago First seen · 132 lines · 1,610 tokens per session scan A 7851fffd5a91

Subscribe to this mod's changes

cursorrules is a cursor rule published in the GitHub repository iamtouchskyer/memex (144 stars, last pushed 1mo ago), licensed MIT. It adds 1,610 tokens to every session, about $0.0064 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.