Skip to main content

​
Overview

The default dashboard is a local web app for monitoring your development progress in real time. It reuses the same dashboard UI components as the VS Code extension, runs against the current workspace, and watches for changes as your project state updates.
Use dashboard for the browser dashboard. Use dashboard-cli when you specifically want the interactive terminal UI.

​
Quick Start

The dashboard auto-detects your flow, starts a local web server, and watches for changes. Press Ctrl+C in the terminal to stop it.

​
Web Dashboard

The web dashboard starts on 127.0.0.1 by default and opens your browser automatically. When you click a document, story, standard, or artifact, specsmd asks your operating system to open that local file from the current workspace. Use it when you are working outside VS Code but still want the same visual planning surface:
  • See the current AI-DLC bolt/run/spec state while coding in another editor or terminal-native agent
  • Review specs, units, stories, standards, and recent completions without running the slower terminal dashboard
  • Keep a browser tab open as a live status board while agents update the local memory-bank, .specs-fire, or specs folder
  • Click through to local markdown documents and artifacts from the dashboard

​
Web Examples

​
Web Dashboard Screenshots

​
Bolts View

SpecsMD web dashboard Bolts view showing current focus, completed bolts, and recent activity

​
Specs View

SpecsMD web dashboard Specs view showing intents, units, and stories from the local memory bank

​
Overview View

SpecsMD web dashboard Overview view showing overall progress, suggested actions, intents, and standards

​
Terminal Dashboard

The terminal dashboard auto-detects your flow and starts watching for changes. Press q to quit.

​
Terminal Dashboard Screenshots

​
Git Changes Tab (Commit Diff Preview)

CLI Dashboard Git Changes tab with commit diff preview

​
Active Tab (File Preview Pane)

CLI Dashboard Active tab with file preview pane

​
Terminal Tabs

The terminal dashboard has five tabs, switched with number keys 1–5:
1

Active Items (1)

Shows currently active runs (FIRE), bolts (AI-DLC), or specs (Simple) in the selected worktree. Includes a split preview pane for inspecting files and an “other worktrees” section showing activity across branches.
2

Intents (2)

Lists all intents in your project. Toggle between pending (n) and completed (x) intents.
3

Completed (3)

Historical view of finished runs, bolts, or specs with intent filtering.
4

Standards & Health (4)

Project standards files (constitution, tech-stack, coding-standards), progress stats, warnings, and error details.
5

Git Changes (5)

Git status with staged, unstaged, untracked, and conflicted files. Select a file to preview its diff in the split pane. Shows branch tracking info with ahead/behind counts.

​
Terminal Keyboard Shortcuts

​
Global

​
Section Focus

​
Terminal Git Worktree Support

The terminal dashboard auto-discovers git worktrees and shows activity across branches.
  • Worktree switcher — press b on the Active tab to switch between worktrees
  • Cross-worktree view — the “Other worktrees” section shows active runs/bolts in other branches
  • Auto-selection — picks the current worktree by default, falling back to main

​
Terminal Dashboard Options

​
Terminal Examples

​
Icon Sets

Configure icons via the SPECSMD_ICON_SET environment variable:

​
Video Tutorials

Watch both dashboard modes in action: the web dashboard from Chrome/Fabriqa.AI, and the terminal dashboard alongside Codex Desktop App.

CLI and Web Dashboard Tutorials

Learn the browser dashboard and the terminal dashboard workflows