Quick Start

Get your dashboard running in 5 minutes.

1. Install

cargo install --path crates/cerebro

2. Create Config

Place config.toml in your cortex:

[settings]
cache_ttl_hours = 24
opencode_db_path = "~/.local/share/opencode/opencode.db"
output_dir = "./content"

[[projects]]
name = "my-project"
repo_path = "~/Projects/my-project"
active = true

3. Build

cd ~/Projects/my-cortex && cerebro build

This generates your dashboard in ~/Projects/my-cortex/content/.

4. Serve

cd ~/Projects/my-cortex && mdbook serve --port 3456

Open http://localhost:3456 to see your dashboard.

Your First Win

After a few days of use, come back to a dormant project. Instead of:

“Wait, what was I working on? Where did I leave off?”

Your dashboard shows:

Last activity: 3 days ago — “feat: add user authentication”
OpenCode session: “Debugging JWT token refresh”
TODOs left: src/auth.rs:42 — “TODO: handle expired tokens”
Next action: From your notes — “Test the login flow”

That’s the moment cerebro earns its place in your workflow.

Next Steps

Configuration — Customize settings
Dashboard Guide — Understand the output
Commands — All available commands

Keyboard shortcuts