4. Markdown output with mdbook serving

Date: 2026-04-22

Status

Accepted

Context

Cerebro generates a personal dashboard. We need to decide the output format and how to serve it.

Decision

Output will be markdown files served via mdbook:

Generators produce .md files
mdbook serves as a local web server
Output location configurable via config.toml

Output Structure

{dashboard_path}/
├── index.md                    # Overview
├── projects/
│   └── {name}.md            # Per-project pages
├── today.md                  # Today's activity
├── this-week.md              # Weekly activity
└── journal/
    └── {year}/
        └── {mm}/
            └── {dd}.md      # Daily journal

Consequences

Pros

Human-readable output
Easy to version control
mdbook provides search/navigation

Cons

Requires mdbook for serving
Static generation (no live updates)

Notes

Default port is 3000. Use cerebro serve --port X to customize.