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 shipped
- AI-assisted sessions: How many sessions your AI coding tools logged (OpenCode + Pi, only shown if configured)
- TODO totals: Work waiting
Project cards
Each project shows:
- Last activity: When you last worked on it
- Recent commits: What you shipped
- AI-assisted sessions: AI-assisted work
- TODOs: Outstanding items
- Status: From your notes, such as “paused” or “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.
AI-assisted sessions
AI-assisted work sessions with titles and timestamps.
TODOs
List of TODO, Needs Fixing, Hack, and Placeholder 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 by searching or clicking
- 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