{
  "markdown": "# DecRec\n\nAI explores. You decide. DecRec remembers.\n\nShared decision memory across Claude, ChatGPT, Cursor, Codex, and other agents.\n\n[![ChatGPT records DEC-8; Cursor recalls it three weeks later.](demo-poster-play.jpg)](https://decrec.io/#demo)\n\n---\n\n[Install](#install-in-30-seconds) · [Docs](https://decrec.io/docs) · [How it works](#how-it-works) · [Why decisions](#why-decisions-not-everything) · [What the Skill does](#what-the-skill-does) · [What we learned](#what-we-learned-teaching-agents-when-to-remember) · [Privacy](#privacy)\n\n---\n\n## Install in 30 seconds\n\nThis package is an [Agent Plugin](https://agent-plugins.org): a skill plus the DecRec MCP server.\n\n### In Cursor\n\nType this in the chat input as a slash command:\n\n```text\n/add-plugin decrec@https://github.com/decrec-io/decrec-plugin\n```\n\nOr **Settings → Customize → Plugins** and install from that GitHub repo.\n\n### In Claude Code\n\n```text\n/plugin marketplace add decrec-io/decrec-plugin\n/plugin install decrec@decrec\n```\n\n### In Codex CLI\n\n```text\ncodex plugin marketplace add decrec-io/decrec-plugin\ncodex plugin add decrec@decrec\n```\n\n[All clients →](#install)\n\n---\n\n## Your agent forgot. DecRec didn't.\n\n### 3 weeks ago — ChatGPT\n\n> Keep accounts single-user until we validate team demand.\n\n✓ Committed as DEC-8\n\n### Today — Cursor, fresh conversation\n\n> Before changing the account model: DEC-8 deliberately kept accounts\n> single-user while validating demand. Want to revisit it?\n\nOne decision. Any agent.\n\n---\n\n## How it works\n\nMCP gives the agent access to decisions. The Skill teaches it when those decisions matter.\n\n```text\nAgent\n  ├─ Skill → judgment: when decisions matter\n  └─ MCP   → durable decision state\n               ↕\n             DecRec\n```\n\n\n| Layer      | Role                                                                                |\n| ---------- | ----------------------------------------------------------------------------------- |\n| **Skill**  | Judgment: what counts as a decision, when to recall, when to capture, when to stop. |\n| **MCP**    | Durable state: search, create, update, admit, commit, and archive decisions.        |\n| **DecRec** | The shared system of record across chats and agents.                                |\n\n\nTools without the skill still write; the skill without tools cannot persist across agents.\n\n---\n\n## Why decisions, not everything?\n\nDecRec remembers decisions, not AI output. Agents can prepare and surface records; a human commits the decision.\n\nYour agent already has access to code, chats, docs, and project context. DecRec doesn't try to remember all of it.\n\nIt keeps the smaller set of choices that constrain future work:\n\n- what you chose\n- why\n- what you considered\n- who committed it\n- what would justify revisiting it\n\n> The goal isn't more context. It's giving a fresh agent the reasoning behind decisions already made.\n\n---\n\n## What the Skill does\n\n- **Stay in scope** — don't advance past what was asked (no catalog → shape → update → explore → admit → commit chain unless requested).\n\n- **Recall** — search only at a decision boundary (consequential choice that constrains later work). Never before ordinary coding.\n\n- **Capture** — offer once when a consequential fork settles; never auto-create; never interrupt trivia.\n\n- **Humans commit** — the agent can prepare and surface records, but it does not place commitments.\n\nFull protocol: [`skills/decrec/SKILL.md`](skills/decrec/SKILL.md). Exploration prompts: [`skills/decrec/explore-prompts.md`](skills/decrec/explore-prompts.md).\n\n### Try it\n\nAfter install, allow the MCP connection, then paste one of these into a new conversation:\n\n#### Live choice\n\n```text\nShould we [option A] or [option B]?\n\nWork through it from more than one side, then record the decision in DecRec.\n```\n\nOr substitute any real decision you're working through.\n\n#### A thread\n\n```text\nHere is a [Slack thread / meeting notes]. What is worth recording in DecRec? Don't record until I pick.\n\n[paste]\n```\n\n#### Already picked\n\n```text\nWe picked [option A] over [option B]. Record that decision in DecRec.\n```\n\n---\n\n## Install\n\n| Client                                              | Start here                                         |\n| --------------------------------------------------- | -------------------------------------------------- |\n| [Cursor](#cursor)                                   | Slash command below, or Settings → Plugins         |\n| [Claude Code](#claude-code)                         | `/plugin marketplace add`                          |\n| [Codex CLI](#codex-cli)                             | `codex plugin marketplace add`                     |\n| [Claude (Web and Desktop)](#claude-web-and-desktop) | Add marketplace `decrec-io/decrec-plugin`          |\n| [ChatGPT](#chatgpt)                                 | Work: marketplace plugin. Chat: MCP + skill zip    |\n| [VS Code](#vs-code)                                 | Command Palette → Chat: Install Plugin From Source |\n| [Other](#other)                                     | Copy skill files + MCP connector                   |\n\n### Cursor\n\nType this in the chat input as a slash command:\n\n```text\n/add-plugin decrec@https://github.com/decrec-io/decrec-plugin\n```\n\nOr **Settings → Customize → Plugins** and install from that GitHub repo.\n\n### Claude Code\n\n```text\n/plugin marketplace add decrec-io/decrec-plugin\n/plugin install decrec@decrec\n```\n\n### Codex CLI\n\n```text\ncodex plugin marketplace add decrec-io/decrec-plugin\ncodex plugin add decrec@decrec\n```\n\n### Claude (Web and Desktop)\n\nSame path on both. Skill and MCP come with the plugin.\n\n1. **Customize** → **Plugins** → **Add** → **Add marketplace**\n2. URL: `decrec-io/decrec-plugin`\n3. **Sync** → select **DecRec** → **Install**\n4. Allow when asked.\n\n### ChatGPT\n\n#### Desktop (Work)\n\nMarketplace plugin. Does not run in **Chat**.\n\n1. Open **Plugins** → **Add** → **Add a marketplace**.\n2. Source: `decrec-io/decrec-plugin`\n3. **Add marketplace**, then install **decrec**.\n4. Allow when asked. Start a **new Work** conversation.\n\n#### Web and Desktop (Chat)\n\nMarketplace plugin does not run here. Add MCP and the skill on [chatgpt.com](https://chatgpt.com).\n\n**MCP** (tools only — no skill):\n\n1. **Plugins** → **+**\n2. Connection: **Server URL**\n3. URL: `https://decrec.io/mcp`\n4. **Create**. Allow when asked. Start a **new** conversation.\n\n**Skill:**\n\n1. Download ZIP from the [GitHub repo](https://github.com/decrec-io/decrec-plugin/archive/refs/heads/main.zip)\n2. **Plugins** → **Skills** → **+** → upload that zip\n\n### VS Code\n\nCommand Palette (`Cmd+Shift+P` / `Ctrl+Shift+P`), then:\n\n```text\nChat: Install Plugin From Source\n```\n\nPaste the GitHub URL and press Enter:\n\n```text\nhttps://github.com/decrec-io/decrec-plugin\n```\n\n### Other\n\nCopy [`skills/decrec/*.md`](https://github.com/decrec-io/decrec-plugin/tree/main/skills/decrec) (`SKILL.md` and `explore-prompts.md`) into your client's skill directory. Add an MCP connector to `https://decrec.io/mcp`.\n\n---\n\n## What we learned teaching agents when to remember\n\nUseful even if you never use DecRec. Steal these for your own agent skills.\n\n### 1. Capture only when all three hold\n\nAlternatives (≥2 paths), consequence (constrains later work), future relevance (someone will ask *why*).\n\n### 2. Don't advance past the ask\n\nMatch the stage they requested; stop there.\n\n### 3. Recall only at a decision boundary\n\nNot before ordinary coding, bugfixes, or implementing an already-chosen approach.\n\n### 4. Fail-fast and branch on error codes\n\n`locked`, `in_flight`, and `pin_mismatch` mean stop (or reload). Don't infer from the chat and retry.\n\n### 5. Isolated role passes\n\nExplore from clean contexts; the agent synthesizes options, the agent does not commit.\n\n### 6. No invented facts\n\nDon't invent stack, vendors, tenancy, or business metrics the brief doesn't state.\n\nSee [`skills/decrec/SKILL.md`](skills/decrec/SKILL.md) for the full rules.\n\n---\n\n## Privacy\n\nThis plugin connects to the remote MCP server at `https://decrec.io/mcp` (OAuth). DecRec stores account email, organization membership, and decision content you choose to record. Details: [Terms & data policy](https://decrec.io/legal#data). Support: [hello@decrec.io](mailto:hello@decrec.io).\n",
  "bytes": 8230,
  "sha": "aaf0c3418cd5cbf07335c360778b3e3eba634b12618034d0a99d443cb1423f5d",
  "repo_slug": "decrec-io/decrec-plugin",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_decrec_decrec_15ab0e2c/readme"
}