capy-cortex

Category: Data & AI | Uploader: ndpvt-web | Downloads: 0 | Version: v1.0（Latest）

Autonomous learning system - learns from mistakes, reflects on sessions, and gets smarter over time. The AI brain.

Changelog: Source: GitHub https://github.com/ndpvt-web/capy-cortex

Directory Structure

Current level: Root

📁 .github/
- 📄 happycapy-logo.png 787.9 KB
- 📄 happycapy-textlogo.svg 21.2 KB
📁 dashboard/
- 📁 public/
  - 📄 favicon.svg 9.3 KB
  - 📄 icons.svg 4.9 KB
- 📁 src/
  - 📁 assets/
    
    📄 hero.png 43.9 KB
    
    📄 react.svg 4.0 KB
    
    📄 vite.svg 8.5 KB
  - 📁 components/
    
    📁 charts/
    
    📄 CategoryDonut.tsx 2.2 KB
    
    📄 ConfidenceBar.tsx 1.6 KB
    
    📄 EventsTimeline.tsx 1.8 KB
    
    📄 HealthGauge.tsx 1.7 KB
    
    📄 SeverityBreakdown.tsx 1.7 KB
    
    📁 layout/
    
    📄 Footer.tsx 896 B
    
    📄 Header.tsx 3.0 KB
    
    📁 metrics/
    
    📄 MetricCard.tsx 1.3 KB
    
    📄 MetricsGrid.tsx 1.1 KB
    
    📁 shared/
    
    📄 StatusBadge.tsx 709 B
    
    📁 tables/
    
    📄 AntiPatternsPanel.tsx 1.7 KB
    
    📄 DiaryPanel.tsx 1.2 KB
    
    📄 EventsFeed.tsx 2.3 KB
    
    📄 PreferencesPanel.tsx 1.1 KB
    
    📄 PrinciplesPanel.tsx 1.5 KB
    
    📄 RulesPanel.tsx 1.7 KB
  - 📁 hooks/
    
    📄 useAnimatedValue.ts 923 B
  - 📁 lib/
    
    📄 api.ts 445 B
    
    📄 types.ts 1.1 KB
    
    📄 utils.ts 1.4 KB
  - 📁 styles/
    
    📄 globals.css 1.8 KB
  - 📄 App.tsx 4.7 KB
  - 📄 main.tsx 529 B
- 📄 .gitignore 253 B
- 📄 eslint.config.js 616 B
- 📄 index.html 636 B
- 📄 package-lock.json 149.5 KB
- 📄 package.json 960 B
- 📄 README.md 2.4 KB
- 📄 tsconfig.app.json 732 B
- 📄 tsconfig.json 119 B
- 📄 tsconfig.node.json 653 B
- 📄 vite.config.ts 384 B
📁 embeddings/
- 📄 ids.json 1.6 KB
📁 hooks/
- 📄 on_pre_bash.py 4.2 KB
- 📄 on_pre_write.py 2.8 KB
- 📄 on_prompt_submit.py 7.0 KB
- 📄 on_session_start.py 5.1 KB
- 📄 on_stop.py 14.4 KB
- 📄 on_tool_failure.py 11.2 KB
- 📄 on_tool_success.py 3.9 KB
📁 scripts/
- 📄 bootstrap.py 8.9 KB
- 📄 bridge_claudeception.py 8.1 KB
- 📄 bridge_forge.py 9.9 KB
- 📄 classify_existing_rules.py 1.9 KB
- 📄 consolidate.py 13.1 KB
- 📄 cortex.py 13.8 KB
- 📄 embeddings.py 6.2 KB
- 📄 evaluate.py 12.3 KB
- 📄 graph_builder.py 10.6 KB
- 📄 llm_extract.py 11.3 KB
- 📄 migrate_dedup.py 6.5 KB
- 📄 migrate_topics.py 2.6 KB
- 📄 reflect.py 13.3 KB
- 📄 setup.py 3.8 KB
- 📄 temporal.py 13.8 KB
- 📄 topic_engine.py 5.0 KB
📄 .gitignore 277 B
📄 dashboard.py 6.8 KB
📄 LICENSE 1.0 KB
📄 README.md 14.9 KB
📄 SKILL.md 2.3 KB

SKILL.md

---
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

```bash
# Check system health
python3 ~/.claude/skills/capy-cortex/scripts/cortex.py stats

# Retrieve rules for a topic
python3 ~/.claude/skills/capy-cortex/scripts/cortex.py retrieve "react typescript"

# Add a rule manually
python3 ~/.claude/skills/capy-cortex/scripts/cortex.py add-rule "Always use TypeScript strict mode" "best_practice"

# Add an anti-pattern
python3 ~/.claude/skills/capy-cortex/scripts/cortex.py add-ap "Never force push to main" "critical"

# Add a preference
python3 ~/.claude/skills/capy-cortex/scripts/cortex.py add-pref "User prefers functional components over class components"

# Run consolidation (clusters rules into principles)
python3 ~/.claude/skills/capy-cortex/scripts/consolidate.py

# Retrain TF-IDF model
python3 ~/.claude/skills/capy-cortex/scripts/cortex.py retrain

# Apply confidence decay
python3 ~/.claude/skills/capy-cortex/scripts/cortex.py decay
```

## How It Learns

1. **Automatic** (via hooks): Errors are captured, corrections noted, preferences extracted
2. **Reflection**: Deep analysis of session transcripts extracts patterns
3. **Consolidation**: sklearn clustering groups similar rules into principles
4. **Decay**: Old, unreinforced rules fade; validated rules strengthen
5. **Retrieval**: Two-stage FTS5 + TF-IDF returns only relevant knowledge (O(1) context)

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

capy-cortex

Directory Structure

SKILL.md

Report

Notice