Claude Code

The plugin connects Claude Code to your memory and keeps it honest: it searches before it answers, reads what the memory knows about a file before it edits it, and records what it learned before it ends a turn.

Install

1. In Claude Code, add the marketplace and install the plugin:

   /plugin marketplace add julymetodiev/post-cortex
   /plugin install post-cortex@post-cortex

2. Give it your key. Either sign the pcx CLI in once per machine, which every client then uses:

   pcx login --token <your key>

   or give the key to the plugin alone with /plugin configure post-cortex@post-cortex. The key is kept in the macOS Keychain, never in settings.json.

3. Start a new session in your project. The first prompt shows a short banner with the session and workspace it uses.

Make keys in the app under Connections. A key can reach the whole organization or chosen workspaces, read only or read and write.

Options

Option	Default	What it is
url	https://api.pcx.is	The server, without a trailing slash. For your own daemon: http://127.0.0.1:3737, or its host.
api_key	empty	Your cloud API key, or your daemon’s auth_token. Empty for a local daemon without a token.

Change them with /plugin configure post-cortex@post-cortex. Every write the plugin makes is signed claude-code.

What the plugin adds

• The MCP server post-cortex, with the memory tools (semantic_search, update_conversation_context, …) and the tools of every module your organization runs.
• The skill post-cortex-memory: when to search, what to record and how.
• The hooks, which work without asking:

When	What it does
A session starts	Puts your user card and the project card in front of the session
Every prompt	Reminds the agent of the memory rules and the session it logs to
After compaction	Puts the rules and the session back
Before an edit	Tells the agent what the memory knows about the file: past problems, decisions, who depends on it
After many edits	Past 8 changed files with nothing recorded, asks for a record
The turn ends	Stops a turn that changed the project and recorded nothing, and asks for the record

How a project finds its memory

The plugin is installed once and recognizes each project on its own. The first time you work in a repository it creates a workspace and a session named after it. Teammates on the same git remote land in the same workspace.

To pin a project to a chosen workspace, run once at its root:

pcx setup --project

It writes .post-cortex.json with the session and workspace ids. Commit it, and every teammate and every agent of the project shares the same memory.

Keep the conversation too

By default only records are kept. pcx setup --capture also keeps each prompt and the final answer of every turn in the session, searchable with sources: "messages". Tool output is never sent. What it is for: Conversations.

Turning it off for a while

Set hosts.claude-code.enabled to false in ~/.post-cortex/config.json, or disable the plugin with /plugin.