ado-dashboard

ADO Dashboard

ADO Dashboard is a keyboard-driven terminal dashboard for Azure DevOps (ADO). If you spend your day reviewing PRs, triaging work items, and managing AI coding sessions — this keeps all of it in your terminal, no browser tabs required.

Demo Mode

Try the dashboard instantly — no ADO credentials, no setup wizard, no real data.

ado-dashboard --demo
# or
ADO_DASHBOARD_DEMO=1 ado-dashboard

The --demo flag populates every tab with fictional Tolkien-themed fixture data (Middle-earth org, Fellowship project, Gandalf the Grey as user). It's perfect for screenshots, presentations, or just exploring the interface before connecting to a real ADO org. No Azure CLI calls are made.

Install & Run

Screenshots above and below were captured in --demo mode with fictional Middle-earth data.

git clone https://github.com/gaburn/ado-dashboard.git
cd ado-dashboard
pip install -e .
ado-dashboard

On first launch an interactive setup wizard walks you through configuration. Re-run it any time with ado-dashboard --setup.

Prerequisites

Tabs

Screenshots

Reviewing — PRs where you are a reviewer

Work Items — assigned items across Epic / Feature / Story / Task / Bug

Triage — priority-grouped board with AI-assisted categorization

Copilot Sessions — resumable AI sessions with intent and last-active timestamps

Keyboard Shortcuts

Configuration

Settings are resolved in order: CLI args → environment variables → config file → defaults.

Config file location: %LOCALAPPDATA%\ado-dashboard\config.json (Windows) or ~/.config/ado-dashboard/config.json (Linux/macOS).

CLI Flags

Environment Variables

In Settings (s), the Triage Boards section lets you configure multiple boards with separate Name and URL fields, then add/remove entries dynamically. Boards are stored in config.json as [display_name, url] pairs.

UI Details

• Status bar — global counts per tab plus triage priority breakdown.
• Dark theme with ADO blue accent.
• Version displayed in the title bar, including git commit hash (e.g., v0.2.0 (a3b4c5d)) for detecting stale instances.
• AI triage — pluggable investigation backend (see docs/investigation.md) with rule-based fallback when no backend is configured.
• Triage board selector — dropdown to switch between configured ADO triage boards with a loading indicator while data refreshes.
• Investigation launcher — press i/I to launch AI-powered investigation sessions for triage items. Requires a configured InvestigationLauncher (see docs/investigation.md).
• Dynamic settings — investigation model and agent dropdowns are populated from the active launcher at runtime.
• Title cleanup — board name prefixes are automatically stripped from triage item titles for cleaner display.
• Search — press / to open a search bar that filters the active tab's table in real-time. Press Enter to keep the filter, Escape to clear it. Works on My PRs, Reviewing, Work Items, and Copilot Sessions tabs.

How It Works

ADO Dashboard is a Textual TUI. It calls the az CLI asynchronously to fetch data from Azure DevOps, keeping the UI responsive. Detail views fetch richer metadata in the background (az repos pr show, az boards work-item show). Triage data comes from a configurable PowerShell script (see docs/triage-and-investigation.md). Investigation sessions are launched via the configured InvestigationLauncher adapter (see docs/investigation.md).

---

Architecture

See docs/architecture.md for module map and async model.

---

For Contributors

---

Troubleshooting / FAQ

az login not authenticated Run az login to sign in, then az account set --subscription <name-or-id> to select the right subscription.

No PRs or work items showing Verify your org URL in the config file (%LOCALAPPDATA%\ado-dashboard\config.json on Windows, ~/.config/ado-dashboard/config.json on Linux/macOS). Re-run ado-dashboard --setup to reconfigure from scratch.

PowerShell not found (Triage tab) Install pwsh or point the triage script to the Windows built-in powershell. PowerShell is only needed if you use the Triage tab.

Triage tab shows "No triage board configured" That's expected — Triage is opt-in. Press s to open Settings and add a board URL.

App shows version v0.2.1-dirty Your working tree has uncommitted changes. Commit or stash them and restart the app.