| name | capy-cortex |
| description | Autonomous learning system - learns from mistakes, reflects on sessions, and gets smarter over time. The AI brain. |
Capy Cortex - Autonomous Learning System
You have a persistent learning brain powered by SQLite + FTS5 + sklearn TF-IDF.
Knowledge is automatically loaded via hooks. This file describes manual operations.
Architecture
- Database:
~/.claude/skills/capy-cortex/cortex.db (SQLite + FTS5 + WAL)
- Hooks (automatic, never call manually):
- SessionStart: Loads anti-patterns, preferences, principles
- UserPromptSubmit: Retrieves task-relevant rules via FTS5
- PreToolUse(Bash): Blocks known dangerous commands
- PostToolUseFailure: Records errors as anti-patterns
- Stop: Extracts corrections and preferences from conversation
- Scripts (for manual/scheduled use):
cortex.py: Core engine (retrieve, add rules, stats)
reflect.py: Deep session analysis
consolidate.py: Cluster rules into principles (sklearn)
bootstrap.py: Mine historical sessions
Manual Commands
python3 ~/.claude/skills/capy-cortex/scripts/cortex.py stats
python3 ~/.claude/skills/capy-cortex/scripts/cortex.py retrieve "react typescript"
python3 ~/.claude/skills/capy-cortex/scripts/cortex.py add-rule "Always use TypeScript strict mode" "best_practice"
python3 ~/.claude/skills/capy-cortex/scripts/cortex.py add-ap "Never force push to main" "critical"
python3 ~/.claude/skills/capy-cortex/scripts/cortex.py add-pref "User prefers functional components over class components"
python3 ~/.claude/skills/capy-cortex/scripts/consolidate.py
python3 ~/.claude/skills/capy-cortex/scripts/cortex.py retrain
python3 ~/.claude/skills/capy-cortex/scripts/cortex.py decay
How It Learns
- Automatic (via hooks): Errors are captured, corrections noted, preferences extracted
- Reflection: Deep analysis of session transcripts extracts patterns
- Consolidation: sklearn clustering groups similar rules into principles
- Decay: Old, unreinforced rules fade; validated rules strengthen
- Retrieval: Two-stage FTS5 + TF-IDF returns only relevant knowledge (O(1) context)