Claudia
43d033e242
Modules: triage, health_scanner, feedback_loop, memory_hygiene,
roadmap, validate_output, enhanced_search, auto_handoff
+ composite_scorer, intent_classifier
CLI: 'cortex <module> <command>' unified entry point
Tests: 157/169 passing (12 assertion mismatches from rename)
Docker: python:3.11-slim based
62 lines
1.9 KiB
Markdown
62 lines
1.9 KiB
Markdown
# Cortex 🧠
|
||
|
||
Intelligence layer for [OpenClaw](https://github.com/moltbot/moltbot). The higher-order thinking above the nervous system.
|
||
|
||
## Modules
|
||
|
||
| Module | Command | What it does |
|
||
|--------|---------|-------------|
|
||
| **Triage** | `cortex triage score "text"` | Priority scoring (urgency × importance × effort × readiness) |
|
||
| **Health Scanner** | `cortex health [--json]` | Proactive system health checks |
|
||
| **Feedback Loop** | `cortex feedback --since 6h` | Extract lessons from session transcripts |
|
||
| **Memory Hygiene** | `cortex hygiene stats\|stale\|duplicates\|orphans\|archive` | Keep memory clean |
|
||
| **Roadmap** | `cortex roadmap list\|add\|overdue\|report` | Task tracking with deadlines & dependencies |
|
||
| **Validate** | `cortex validate --transcript <path>` | Sub-agent output validation |
|
||
| **Enhanced Search** | `cortex search "query"` | Multi-strategy memory search |
|
||
| **Auto Handoff** | `cortex handoff <file>` | Generate session handoff documents |
|
||
|
||
## Install
|
||
|
||
```bash
|
||
pip install -e .
|
||
```
|
||
|
||
## Docker
|
||
|
||
```bash
|
||
docker build -t cortex .
|
||
docker run cortex triage score "production down"
|
||
```
|
||
|
||
## Tests
|
||
|
||
```bash
|
||
python -m pytest tests/ -v
|
||
```
|
||
|
||
## Architecture
|
||
|
||
Cortex is a standalone Python package that OpenClaw calls via CLI. No tight coupling, no plugin system — just clean Unix-style commands.
|
||
|
||
```
|
||
OpenClaw (Node/TS)
|
||
│
|
||
├── cortex triage score "..." ← CLI calls
|
||
├── cortex health --json
|
||
├── cortex feedback --since 6h
|
||
└── cortex hygiene stats
|
||
│
|
||
└── Cortex (Python)
|
||
├── triage.py
|
||
├── health_scanner.py
|
||
├── feedback_loop.py
|
||
├── memory_hygiene.py
|
||
├── roadmap.py
|
||
├── validate_output.py
|
||
├── enhanced_search.py
|
||
└── auto_handoff.py
|
||
```
|
||
|
||
## License
|
||
|
||
MIT
|