All shelves / Mods / Workflow
cortexes
By XBlueSky
cortexes is a Claude Code workflow mod by XBlueSky.
For Cortexes, a vault of your recorded sessions, draws its session-start menu as a band above the prompt, and offers a hand-off once the context is 70% full.
Draws
Install
The marketplace name is cortex.
/plugin marketplace add https://github.com/XBlueSky/cortexes.git#plugin /plugin install cortexes@cortex
It runs inside the Claude Code process. The side panel is only what the author's README names. Read the repo before you install, or run claude plugin validate on the plugin folder.
- Version
- 2.2.0
- License
- Apache-2.0
- Repo stars
- 24
- Last change
- 2026-10-21
What it can reach
- Draws in the session
- Reads usage or context figures
- Reaches the network or an outside service
- Calls another program on this machine
Install the cortex-vec CLI too, with uv tool install cortex-vec or pip install cortex-vec, then run /cortexes:genesis with your vault's path. Cortexes writes every session over 4 KB to a Markdown vault when it ends, distills the records into notes, and searches them. At session start it checks the vault and asks what to do next. The hooks module draws that menu as a band above the prompt, where the digits 1 to 9 press its buttons. Without the module the model shows the menu as text. Once per context window, at 70 percent use, the band offers a hand-off, /cortexes:takeoff, for a later session to resume. OPENAI_API_KEY is optional. With it, vault pages go to OpenAI for embeddings and semantic search. Without it, search runs on a local BM25 index. The author says oversized transcript blocks go to Anthropic through your own Claude Code to be classified, which CORTEX_NO_CLASSIFIER=1 turns off, and that a git push to a remote you set is off by default.
The marketplace name is cortex, kept from 1.x, when the plugin was also called cortex. The plugin lives on the repository's plugin branch, and the install adds that branch. The session-start band is why this page files it under workflow. cognee-memory draws a memory status row above the prompt, with a dataset picker, and recalls saved context each turn. compact-handoff writes a handoff, replaces the conversation with it, and toasts once context passes 70%. This one records each session to a vault you own, and its band offers the vault's next step and a hand-off. In the source, the band's hide and hand-off buttons and the hand-off toast are in Traditional Chinese.
Demo

What it hooks into
session.appendWhen an entry is written to the transcriptsession.startWhen a session startsprompt.submitWhen you send a promptsession.measureWhen usage is measuredui.renderDraws into the sessionAbovePrompt
Read from the on() calls in its hook modules. Open its source under Files to check what each one does.
Hooks 2
SessionEndbash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/session-end-record.shSessionStartbash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/session-start-inject.sh
Files
The author's README and source, 5 files. They load when you open them.
Facts
- Author
- XBlueSky
- Category
- Workflow
- Marketplace
- cortex
- Version
- 2.2.0
- License
- Apache-2.0
- Repo stars
- 24
- Last change
- 2026-10-21
- Language
- Python
- Files
- 256