darkplex-core/README.md
Claudia 43d033e242 feat: initial cortex package — 8 intelligence modules, CLI, Docker
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
2026-02-09 11:18:20 +01:00

1.9 KiB
Raw Blame History

Cortex 🧠

Intelligence layer for OpenClaw. 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

pip install -e .

Docker

docker build -t cortex .
docker run cortex triage score "production down"

Tests

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