🧠 Genius Cortex

Multi-repo orchestration for vibe coders.

Your AI coding toolkit manages one project at a time. Cortex manages all of them.

What it does

• See all your projects — versions, health scores, last activity
• Shared behaviors — coding habits that follow you everywhere ("prove before fix", "post-fix audit")
• Cross-project memory — knowledge captured in one project, available in all
• Project factory — new project in 30 seconds (template → GitHub → GT installed → Claude launched)
• Secrets vault — encrypted API keys, injected per-project
• AI tool watch — Claude Code updated? Cortex tells you.

Install

# One-liner (recommended)
bash <(curl -fsSL https://raw.githubusercontent.com/w-3-art/genius-cortex/main/install.sh)

# Or manual
git clone https://github.com/w-3-art/genius-cortex.git ~/.genius-cortex-cli
cd ~/.genius-cortex-cli && npm install && npm link

# Then initialize
cortex init

Commands

cortex init          — Set up Cortex (scan repos, install behaviors)
cortex scan          — Find Genius Team repos
cortex status        — See all projects + versions
cortex upgrade       — Update GT in your repos
cortex behaviors     — Manage coding behaviors (7 starters included)
cortex rules         — Rules you NEVER break (enforced via CC hooks)
cortex memory        — Cross-project knowledge store
cortex glossary      — Shared vocabulary
cortex personas      — Client/project context profiles
cortex templates     — Project starters (SaaS, Landing, API, Mobile)
cortex create        — New project from template
cortex vault         — Encrypted secrets management
cortex health        — Project health scores (0-100)
cortex search        — Search code across all repos
cortex codebits      — Reusable code snippets
cortex watch         — AI tool news feed
cortex sessions      — Session history
cortex inject        — Push behaviors + rules into Claude Code

Behaviors

Cortex ships with 7 starter behaviors:

| Behavior | What it does | |----------|-------------| | prove-before-fix | Never fix based on assumptions. Read → Reproduce → Identify → Fix. | | post-fix-audit | After every fix: re-test, check regressions, review diff. | | verify-before-code | Read existing code before writing new code. | | no-rush-quality | Quality over speed. Always. | | cumulative-feedback | New feedback adds to previous. Never replaces. | | read-before-write | Read the file/tests/README before editing. | | minimal-change | Change only what needs to change. |

Run cortex behaviors --inject to activate them in every Claude Code session.

How it works

Cortex writes to ~/.claude/CLAUDE.md (user-level). Claude Code loads this file in every session, on every project. Your behaviors, rules, and glossary are always active.

Requirements

• Node.js 18+
• Genius Team installed on your projects
• Claude Code (for hook integration)

License

MIT

Built with Genius Team. Open source.