Dashboard Guide
Understanding the output cerebro generates.
Output Structure
{cerebro-dashboard}/
├── index.md # Your mission control
├── today.md # Today's activity
├── this-week.md # This week's activity
├── projects/
│ └── {name}.md # Per-project pages
└── journal/
└── {year}/
└── {mm}/
└── {dd}.md # Daily journal pages
index.md — Your Mission Control
The main dashboard shows:
Activity Overview
- Projects at a glance — Which have recent activity
- Git commit counts — How much you’ve shiped
- OpenCode session counts — How much AI help you’ve received
- TODO totals — Work waiting to be done
Project Cards
Each project shows:
- Last activity — When you last worked on it
- Recent commits — What you shipped
- OpenCode sessions — AI-assisted work
- TODOs — Outstanding items
- Status — From your notes (e.g., “paused”, “actively developing”)
- Next action — Your stated next step
projects/{name}.md — Deep Dive
Click any project card to see full context:
Header
- Repository path
- Last activity timestamp
- Status badge
Your Notes
Whatever you’ve written in notes/projects/{name}.md:
## Status
building: integrating Stripe API
## Next
- Test webhook endpoints locally
- Deploy to staging
Git Activity
Recent commits with messages, dates, and files changed.
OpenCode Sessions
AI-assisted work sessions with titles and timestamps.
TODOs
List of TODO/FIXME/HACK/XXX items found in code:
- TODO: handle expired JWT tokens (src/auth.rs:42)
- FIXME: race condition in cache (src/cache.rs:18)
- HACK: temporary rate limiting (src/api.rs:103)
today.md — Daily Pulse
Today’s activity, scoped to the last 24 hours.
this-week.md — Weekly Review
This week’s activity, scoped to 7 days.
journal/{date}.md — Historical Record
Daily pages with all activity for that date. Useful for:
- Reviewing what you accomplished
- Identifying patterns in your work
- Journaling your development journey
Using the Dashboard
For Context Switching
When returning to a project:
- Open the dashboard
- Find your project (search or click)
- Read: status → next → TODOs → recent activity
For Daily Standup
- Check
today.mdfor today’s work - Review
this-week.mdfor the week’s progress
For Planning
- Read your notes in each project
- Review TODOs to see what’s left
Customization
The dashboard is just markdown. You can:
- Add it to git for version control
- Deploy it to a static host
- Customize the templates in
generators/ - Add your own data sources