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

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

  1. Open the dashboard
  2. Find your project (search or click)
  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