ClaudeCodeMod

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.

In Claude Code
/plugin marketplace add https://github.com/XBlueSky/cortexes.git#plugin
/plugin install cortexes@cortex
Open the repo

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

The Hooks table of the Cortexes README: the session report at SessionEnd, the memory menu at SessionStart, and Deck, the hooks module that draws that menu as a band above the prompt and offers a hand-off at 70% context.
Screenshot of the author's GitHub page.

What it hooks into

  • session.appendWhen an entry is written to the transcript
  • session.startWhen a session starts
  • prompt.submitWhen you send a prompt
  • session.measureWhen usage is measured
  • ui.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.sh
  • SessionStartbash ${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
Repo
XBlueSky/cortexes
Version
2.2.0
License
Apache-2.0
Repo stars
24
Last change
2026-10-21
Language
Python
Files
256

Other mods in Workflow

proof9frankbriaHolds a commandTurns a bug into a CodeFRAME requirement and checks the ledger before each git commit Claude makes, warning by default or denying in block mode.directorEvolvingAgentsLabsHolds a commandKeeps a team's way of working as linked statements Claude plans from, and draws a status line and a band to run a waiting plan or accept a lesson it learned.bigquery-agent-analytics-modGoogleCloudPlatformStreams each session's prompts, model requests, tool calls, and subagents as rows to your BigQuery table, and says above the prompt when they land.next-stepsbradtraversyAfter each turn, has Haiku suggest two or three next prompts above the prompt, as buttons on the desktop that draft one, or 1, 2, and 3 in the terminal.critical-decisionsMucidaHas Claude record each call it made that you never asked for, with the reason, in a band above the prompt, red or yellow, with ok, rethink, and not critical.painelGabrielPauloTOpens a side panel, in Portuguese, of the running tool, Claude's latest thinking, its plan steps, the files it edited with line counts, subagents, and context.tavernweave-agent-skillsLiarMTTTDraws a Soul switch above the prompt that fills a persona's instruction into the prompt box, beside 23 skills for building SillyTavern character cards.hopper-hqFairMind-Gen-AI-StudioDraws a band above the prompt while another session waits for you or has finished, and opens hopper-hq, a browser office where each session has a desk.taskplannersmekaiOpens a board of the repo's .tasks/ Markdown tasks beside the transcript to move, add, or start one with Claude, and names the one in progress above the prompt.agent-taskskeshrathOpens agent-tasks' stage-gated pipeline in a /pipeline pane beside the conversation: tasks by stage, artifacts and comments, advance, send back, and complete.deltazed-industriesRecords this session and its Git checkout to Delta, asks who should see it on /delta-share, and lets a teammate join the thread from their own Claude Code.ci-lightdavekissDraws a red row above the prompt while the repo's default branch fails CI, with how long and how many pushes since, and a quiet green under it otherwise.
All 396 in Workflow