Git repository dashboard for your local codebase. Scans all git repos under a directory and shows status, activity, health — with batch operations and lazygit integration.

• Dashboard — Overview of all repos: branch, last commit, dirty status, language, remote
• Activity — Cross-repo commit timeline
• Health — Find uncommitted changes, unpushed commits, repos behind remote, inactive repos
• Detail — Deep dive into a single repo: contributors, languages, recent commits
• Stats — Aggregate statistics: language distribution, weekly top, remote distribution
• Grep — Search code across all repos
• Batch ops — Pull all, push all, quick commit, stash
• lazygit — Open repos in lazygit, process dirty repos interactively
• Doc — Generate Obsidian project documentation (optional)
• Graph — Code graph analysis via GitNexus (optional)

pip install .

Or run directly:

python codeboard.py

# Main dashboard
codeboard

# Or use the short alias after pip install
cb

# Filter repos by name
cb --filter simona

# Sort by dirty file count
cb --sort changes

# Cross-repo commit timeline
cb activity --limit 50

# Health check
cb health

# Single repo details
cb detail myrepo

# Summary statistics
cb stats

# Search code across all repos
cb grep "TODO"

# Batch pull all repos
cb pull

# Push all repos with ahead commits
cb push

# Quick commit
cb commit myrepo -m "feat: something" -y

# Stash / unstash
cb stash myrepo
cb stash myrepo pop

# Open in lazygit
cb open myrepo log

# Process all dirty repos one by one
cb each

# JSON output for piping
cb --json | jq '.[]'

# Auto-refresh every 10 seconds
cb --watch 10

Config file: ~/.config/codeboard/config.toml

Generate a default config:

cb config

# Directory to scan for git repositories
scan_dir = "~/Code"

# Additional individual repos to include (outside scan_dir)
extra_repos = ["~/Projects/special-repo"]

# UI language: "auto", "en", or "zh"
lang = "auto"

# Path to Obsidian vault (for 'doc' command, optional)
# obsidian_vault = "~/Documents/Obsidian Vault"

# Path to gitnexus binary (for 'graph' command, optional)
# gitnexus_bin = ""

Global options can be placed before or after the subcommand:

cb health --filter simona    # works
cb --filter simona health    # also works

CodeBoard can run as an MCP server, letting AI assistants (Claude Code, Cursor, etc.) query your repo status directly.

Add to your Claude Code MCP config (~/.claude/claude_desktop_config.json):

{
  "mcpServers": {
    "codeboard": {
      "command": "cb",
      "args": ["mcp"]
    }
  }
}

Available tools:

No extra dependencies — uses stdio JSON-RPC 2.0, zero config.

# Bash (add to ~/.bashrc)
eval "$(cb completions bash)"

# Zsh (add to ~/.zshrc)
eval "$(cb completions zsh)"

# Fish (add to ~/.config/fish/completions/)
cb completions fish > ~/.config/fish/completions/cb.fish

• Python ≥ 3.11
• rich (terminal formatting)
• git
• lazygit (optional, for open/dirty/each)
• gitnexus (optional, for graph)

Windows note: CodeBoard uses sh -c for batched git commands. On Windows, this requires Git for Windows which includes sh. WSL also works.

• Scans 48 repos in ~1 second
• Single shell call per repo (6-9 git commands batched into one sh -c)
• 8-way parallel scanning via ThreadPoolExecutor
• Lazy language detection (skipped for commands that don't need it)

git clone https://github.com/shaoyiyang/codeboard.git
cd codeboard
pip install -e ".[dev]"
pytest

See CONTRIBUTING.md for details.

MIT