ux-product

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:

• Intro Overview
• Technical Deep Dive
• Executive Roadmap
• Feature Catalog

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-detection
• modes/supersaiyan/ – Platform-specific implementations (Web, TUI, CLI, Docs)
• claude_ctx_py/tui_supersaiyan.py – Enhanced Textual components
• examples/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: