Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

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:

  • 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:

  1. Open the dashboard
  2. Find your project by searching or clicking
  3. Read: status → next → TODOs → recent activity

For daily standup

  • Check today.md for today’s work
  • Review this-week.md for 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