Cortex
This repository packages the Cortex (cortex) context management toolkit as a Claude Code plugin.
It bundles the curated agents, commands, modes, rules, and supporting Python CLI + TUI so teams can install the complete experience through the plugin system or keep using the standalone cortex / cortex-ui scripts.
Note: The claude-ctx command has been deprecated but will remain available for a while.
📚 Docs: https://cortex.atlascrew.dev/
🎬 Presentations:
What's Inside
Core Assets (Loaded by Claude Code)
| Directory | Purpose |
|---|
agents/ | Claude subagents with dependency metadata. Move to inactive/agents/ to park. |
commands/ | Slash command definitions (50+ curated commands) |
skills/ | Reusable skill modules (80+ skills) with activation triggers and dependencies |
modes/ | Behavioral context modules that toggle workflow defaults |
rules/ | Rule sets symlinked to ~/.claude/rules/cortex/ on launch |
flags/ | Modular token-efficient flag packs (22 categories, 3,380 tokens total) |
hooks/ | Automation hooks for pre/post tool execution and session events |
Orchestration & Templates
| Directory | Purpose |
|---|
profiles/ | Project type presets (frontend, backend, devops, etc.) |
scenarios/ | Multi-step workflow scenarios |
workflows/ | Complex workstream orchestration templates |
prompts/ | Prompt templates: guidelines, personas, and reusable snippets |
templates/ | Initialization templates for new projects |
plugins/ | Additional plugin modules (accessibility, frontend, UX) |
Python Package (claude_ctx_py/)
| Module | Purpose |
|---|
cli.py | Main CLI entrypoint with all subcommands |
launcher.py | cortex start implementation (plugin resolution, rules symlinking) |
core/ | Core domain logic (agents, skills, modes, rules, hooks, backups) |
tui/ | Textual-based terminal UI with 15+ specialized views |
intelligence/ | AI recommendation engine and pattern learning |
memory/ | Session memory and knowledge persistence |
analytics.py | Usage analytics and skill metrics |
Supporting Files
| Path | Purpose |
|---|
.claude-plugin/plugin.json | Plugin manifest for Claude Code marketplace |
docs/ | Documentation site (Jekyll-based) |
tests/ | Test suite with pytest |
schema/ | JSON schemas for validation |
scripts/ | Helper scripts for installation and maintenance |
🆕 Latest Updates
- Hook logging – Hook failures now write to
~/.cortex/logs/hooks.log (override via CORTEX_HOOK_LOG_PATH).
- Extra plugin dirs –
cortex-config.json supports extra_plugin_dirs to pass multiple --plugin-dir entries.
- Watch daemon mode –
cortex ai watch --daemon runs watch mode in the background with status/stop controls.
- Template guardrails – The TUI detects missing
templates/ files in the active CLAUDE_PLUGIN_ROOT and offers to initialize them or run the setup wizard.
- Multi-LLM consult skill – Ask Gemini, OpenAI (Codex), or Qwen for a second opinion; configure provider API keys via the TUI Command Palette -> "Configure LLM Providers".
- Asset Manager reliability – “Update All” and “Install All in Category” now behave consistently with clearer prompts.
- Flag toggles restored – Spacebar toggling works again in the Flag Explorer and Flag Manager, updating
FLAGS.md immediately.
✅ Stability Update: AI + Context Management
We’ve fixed major issues across AI recommendations and context state tracking. Auto-activation and watch mode are more reliable, and context activation now uses .active-* state files with cortex doctor and cortex setup migrate to keep everything consistent.
🔥 New: Super Saiyan Mode
Universal visual excellence framework with platform detection:
modes/Super_Saiyan.md – Core generic mode with auto-detectionmodes/supersaiyan/ – Platform-specific implementations (Web, TUI, CLI, Docs)claude_ctx_py/tui_supersaiyan.py – Enhanced Textual componentsexamples/supersaiyan_demo.py – Interactive demo- Three power levels: ⭐ Super Saiyan → ⚡ Kamehameha → 💥 Over 9000
Quick start:
python examples/supersaiyan_demo.py # See it in action!
See Super Saiyan Integration Guide for details.
📦 New: Asset Manager
Install, diff, and update plugin assets directly from the TUI: