CEREBRO — Strategic Intelligence Engine

Scan, score, and connect knowledge across a markdown vault. Think like a strategist, not a search engine.

Version: 3.0.1 · License: MIT · Python: 3.11+

---

What It Does

CEREBRO reads a structured markdown vault, scores every note on strategic value, detects time-sensitive signals, maps relationships between entities, and surfaces actionable intelligence — including connections you did not know to look for.

It is not a search tool. Search answers “where is that?” CEREBRO answers “what matters most right now, and what am I missing?”

Findings are structural, not inferred

Every finding is derived from links, tags and frontmatter you actually wrote. Nothing is guessed from prose statistics.

That constraint is the point. A tool that infers meaning from your writing produces confident nonsense, and you cannot tell a real finding from a fabricated one without re-reading every note — which defeats the purpose. Every CEREBRO finding can be verified by opening two files.

---

Install

git clone https://github.com/microhustlestack/cerebro-skill.git
cd cerebro-skill
python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install .
cerebro --version

On Windows PowerShell, activate with .venv\Scripts\Activate.ps1 before running python -m pip install ..

Or deploy as an agent skill at the same time:

bash install.sh              # package + Claude; detected Hermes/OpenClaw
bash install.sh package claude  # install the CLI and one skill target

Explicit targets are package, claude, hermes, and openclaw. Supplying targets replaces the defaults, so include package when you also want the cerebro command installed.

Dependencies: Python 3.11+ and PyYAML. Nothing else.

---

Quick Start

# Full scan with gap analysis
cerebro ~/Documents/Obsidian/my-vault --gaps --report cerebro_report.md

# JSON index for an agent to reason over, gap findings included
cerebro ~/vault output/vault-index.json --gaps --quiet

# Report straight to stdout
cerebro ~/vault --quiet --report -