dobbe

dobbe insight

Engineering intelligence – metrics snapshots and trend analysis with AI narratives.

Subcommands

Subcommand Description
insight dashboard Engineering metrics snapshot with AI-generated insights
insight trends Trends over time with narrative insights and period comparison

insight dashboard

Show a snapshot of current engineering metrics and AI-generated insights.

Synopsis

dobbe insight dashboard [OPTIONS]

Description

insight dashboard collects engineering metrics across your organization (pull request throughput, review latency, deployment frequency, incident rates, etc.) for a given time period and produces an AI-generated summary with actionable insights. It queries available MCP integrations (GitHub, Sentry, Jira, etc.) to build a comprehensive picture of engineering health.

Flowchart

┌─────────────────────────────────────────────┐
│  dobbe insight dashboard --period 30d       │
└──────────────────────┬──────────────────────┘
                       │
                       v
┌─────────────────────────────────────────────┐
│  Parse CLI args + merge config defaults     │
│  - org from --org or config                 │
│  - format from --format or config           │
└──────────────────────┬──────────────────────┘
                       │
                       v
┌─────────────────────────────────────────────┐
│  Discover MCP servers + tools               │
│  (~/.claude/settings.json)                  │
└──────────────────────┬──────────────────────┘
                       │
                       v
┌─────────────────────────────────────────────┐
│  Run dashboard pipeline                     │
│  - Gather metrics from available sources    │
│    (GitHub, Sentry, Jira, etc.)             │
│  - AI analysis of engineering health        │
│  - Generate actionable insights             │
└──────────────────────┬──────────────────────┘
                       │
                       v
┌─────────────────────────────────────────────┐
│  Render output                              │
│  --format table (default) / json / markdown │
│  --output file (optional)                   │
└─────────────────────────────────────────────┘

Options

Option Type Default Description
--period / -p str 30d Time period: 30d, 90d, 1y
--org / -o str - Organization to scope insights to
--format / -f str table Output format: table, json, markdown
--output str - Write output to file instead of stdout
--quiet / -q bool False Suppress progress output, only show final result

If --org is not specified, the default organization from config is used.

Examples

Default 30-day dashboard

dobbe insight dashboard

Quarterly dashboard for a specific org

dobbe insight dashboard --period 90d --org my-org

Year-long dashboard as markdown

dobbe insight dashboard --period 1y --format markdown

Save dashboard to file

dobbe insight dashboard --period 30d --format json --output dashboard.json

Quiet mode for CI

dobbe insight dashboard --period 30d --format json --quiet --output dashboard.json

insight trends

Show trends over time with narrative insights and period comparison.

Synopsis

dobbe insight trends [OPTIONS]

Description

insight trends analyzes engineering metrics over time, identifying patterns such as improving review times, rising incident rates, or deployment frequency changes. When used with --compare, it produces a side-by-side comparison against a prior period (last month or last quarter) and highlights statistically meaningful changes with narrative explanations.

Flowchart

┌─────────────────────────────────────────────┐
│  dobbe insight trends --period 30d          │
│                       --compare last-month  │
└──────────────────────┬──────────────────────┘
                       │
                       v
┌─────────────────────────────────────────────┐
│  Parse CLI args + merge config defaults     │
│  - org from --org or config                 │
│  - format from --format or config           │
└──────────────────────┬──────────────────────┘
                       │
                       v
┌─────────────────────────────────────────────┐
│  Discover MCP servers + tools               │
│  (~/.claude/settings.json)                  │
└──────────────────────┬──────────────────────┘
                       │
                       v
┌─────────────────────────────────────────────┐
│  Run trends pipeline                        │
│  - Gather metrics for current period        │
│  - Gather metrics for comparison period     │
│    (if --compare specified)                 │
│  - AI trend analysis + narrative generation │
│  - Highlight significant changes            │
└──────────────────────┬──────────────────────┘
                       │
                       v
┌─────────────────────────────────────────────┐
│  Render output                              │
│  --format table (default) / json / markdown │
│  --output file (optional)                   │
└──────────────────────┬──────────────────────┘
                       │
                       v
┌─────────────────────────────────────────────┐
│  Optional: Notify                           │
│  --notify slack -> post to --channel        │
│  --notify jira  -> create tickets           │
└─────────────────────────────────────────────┘

Options

Option Type Default Description
--period / -p str 30d Time period: 30d, 90d, 1y
--compare / -c str - Compare with: last-month, last-quarter
--org / -o str - Organization to scope insights to
--format / -f str table Output format: table, json, markdown
--output str - Write output to file instead of stdout
--notify str - Send report to platform (slack, jira)
--channel str - Notification channel (e.g., #engineering)
--quiet / -q bool False Suppress progress output, only show final result

If --org is not specified, the default organization from config is used.

Examples

dobbe insight trends

Compare current month with last month

dobbe insight trends --period 30d --compare last-month
dobbe insight trends --period 90d --compare last-quarter --org my-org

Markdown output to file

dobbe insight trends --period 30d --format markdown --output trends-report.md
dobbe insight trends --period 30d --compare last-month --notify slack --channel "#engineering"

JSON output for downstream processing

dobbe insight trends --period 90d --format json --output trends.json

See Also