Docs menu

For AIs to read

Skills

What the System of Reason skills do, and the one way to add XOR and the skills in each app.

The skills teach an app to save and find your notes the same way every other app does. There are three:

Skill What it does
system-of-reason-memory Saves a note when you ask it to remember something, finds notes when you ask what was decided, and corrects or forgets a note when you ask.
system-of-reason-wrap-up Saves where a piece of work stands when you ask for a wrap-up, and reads it back when you ask to pick up where you left off.
system-of-reason-get-started Shows what your account keeps, and how to save and reuse it from any connected app.

They act when you ask. An app may offer once to save a decision or a wrap-up, and it saves only if you say yes.

If you’d rather not follow the steps yourself, paste the prompt on Get started into your app. It reads the setup guide and does the one install for the app you’re in. The blocks below are that same install.

Do one block. Don’t connect the server by hand and also install the plugin.

Claude Code

In a terminal, not as a slash command inside a chat (inside a chat, /plugin install only opens a panel):

claude plugin marketplace add rblalock/system-of-reason-plugin
claude plugin install system-of-reason@system-of-reason

That connects XOR and adds the skills. In Claude Code, type /mcp, pick system-of-reason, and sign in with your email and the code we send.

Don’t also run claude mcp add.

If XOR is already there because you added it on claude.ai, stop. Don’t install the plugin on top of it. To add only the skills:

npx skills add rblalock/system-of-reason-plugin -s '*'

More on the Claude Code page, including a machine with no browser.

Codex

In a terminal:

codex plugin marketplace add rblalock/system-of-reason-plugin
codex plugin add system-of-reason@system-of-reason

That connects XOR and adds the skills. Codex opens a browser so you can sign in. If it doesn’t, run codex mcp login system-of-reason.

Don’t also run codex mcp add. More on the Codex page.

Cursor

  1. Clone https://github.com/rblalock/system-of-reason-plugin. The repository includes .cursor-plugin/plugin.json.
  2. In Customize, choose Add Marketplace, then Import from Disk.
  3. Install System of Reason.

If you cannot clone, send this in Cursor’s chat instead. That command can stay on the first commit it fetched.

/add-plugin https://github.com/rblalock/system-of-reason-plugin

Do not choose Import from GitHub. A personal marketplace added that way is not indexed, so no plugin appears. Sign in when Cursor asks.

If XOR’s tools do not appear after that, add the server and the skills yourself, once. Don’t do this when the tools are already there. Open ~/.cursor/mcp.json and add:

{
  "mcpServers": {
    "xor": { "url": "https://systemofreason.com/mcp" }
  }
}

Then, in a terminal:

npx skills add rblalock/system-of-reason-plugin -s '*'

More on the Cursor page.

Claude

Claude on the web and in the desktop app doesn’t install this plugin. Add the connector on the Claude page. That is the connection.

To add the skills, download rblalock/system-of-reason-plugin, zip each folder in skills/ (the folder itself, not only its files), and upload each ZIP under Customize, then Skills. Or just ask: “Remember this in XOR.”

ChatGPT

ChatGPT doesn’t install these skills. Add the connector on the ChatGPT page, then ask in plain words: “Remember this in XOR.”

Other apps

Connect the server and, when the app can read skills, add them. The server:

https://systemofreason.com/mcp

Call it XOR. Sign in with your email and the code we send. Steps for Grok, OpenCode, VS Code and the rest are on Other apps.

Skills, in a terminal, for an app that reads them:

npx skills add rblalock/system-of-reason-plugin -s '*'

-s '*' installs all three. Add -g for every project. Don’t use --all. This command copies the skills only. If the app isn’t connected yet, connect the server too. Don’t do it when a plugin install already did both.

A chat app that can’t install skills still works. Ask: “Remember this in XOR.”

Where notes go

A note is a row in the notes table of the default database in the project memory. The first note makes the table. The columns, including topic, are in the setup guide. You can see notes in your account.