Skip to content

Latest commit

 

History

55 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

spectatui β€” TUI dashboard for GitHub Spec-Kit

CI License: MIT Crates.io

A terminal UI dashboard for GitHub Spec-Kit β€” track features, manage specifications, integrations, presets, workflows, extensions and monitor AI agent workflows, all from your terminal.


spectatui demo
πŸ’‘Tip: I recommend installing and using Jetbrains Mono font for a nice looking terminal as seen above


✨ Features

  • 🧩 Extensions manager β€” Browse, add, enable/disable, update, and prioritize Spec-Kit extensions
  • 🎚️ Presets manager β€” Browse, add, enable/disable, update, and prioritize Spec-Kit presets
  • πŸ€– AI Integrations manager β€” Install, switch, upgrade, and inspect Spec-Kit integrations (Claude Code, etc.)
  • πŸ”„ Workflows manager β€” Run, resume, and inspect active Spec-Kit workflows
  • πŸ‘οΈ Live auto-refresh β€” Watches specs/ and .specify/ and updates the dashboard automatically when files change on disk
  • πŸ“– Spec / Plan / Tasks / Research browser β€” Navigate spec.md, plan.md, tasks.md, research.md with rendered Markdown and task checkboxes
  • πŸ“œ Constitution viewer β€” Read your project's .specify/memory/constitution.md from any screen
  • πŸͺœ Workflow stepper β€” Visual stage tracker across cons β†’ spec β†’ clar β†’ plan β†’ task β†’ anly β†’ impl with task progress bar
  • πŸ”— Session attach β€” Suspend the TUI and hand off to a live tmux session; send follow-up messages inline
  • πŸ–₯️ Agent output pane β€” Live tail of the tmux agent session with attach/refresh/kill controls
  • πŸ“€ CLI job output popup β€” Dedicated scrollable view for spawned CLI job output
  • 🎯 Command palette β€” Quick-navigate and execute commands (: or Ctrl-K)
  • πŸ—‚οΈ Multi-pane dashboard β€” Overview, Coding, Audit, and Custom layouts (switch with 1–4)
  • 🎨 Custom layout editor β€” Reorder, resize, and toggle visibility of panes; save as your own layout
  • βš™οΈ Settings editor β€” In-app settings: theme, accent, dashboard layout, mouse support, tmux prefix, and more, persited globally or per-project
  • πŸŒ“ Dark & light themes β€” Toggle with t
  • 🌈 Accent palette β€” Cycle through Indigo, Teal, and Amber with T
  • 🐭 Mouse support β€” Optional click support for list rows, tabs, status-bar counters, and settings chips
  • 🌐 Cross-platform β€” Runs on Linux, macOS, and Windows (x86_64 & ARM)

πŸ“¦ Installation

Linux / macOS
curl -fsSL https://raw.githubusercontent.com/tinesoft/spectatui/main/install.sh | sh

Pass --version to pin a specific release, or --to <dir> to choose an install location:

curl -fsSL https://raw.githubusercontent.com/tinesoft/spectatui/main/install.sh | sh -s -- --version 1.0.0
Windows

Option 1 β€” MSI installer (recommended):

Download spectatui-*-x86_64-pc-windows-msvc.msi from the Releases page and run it. The installer adds spectatui to your system PATH automatically and appears in Add/Remove Programs for easy uninstall.

Silent install (no UI):

msiexec /i spectatui-*-x86_64-pc-windows-msvc.msi /quiet /norestart

Option 2 β€” ZIP (manual):

Download spectatui-*-x86_64-pc-windows-msvc.zip, then in PowerShell:

Expand-Archive spectatui-*-x86_64-pc-windows-msvc.zip -DestinationPath spectatui
Move-Item spectatui\spectatui.exe "$env:USERPROFILE\.cargo\bin\"
GitHub Releases (all platforms)

Download the pre-built binary for your platform from the Releases page, extract the archive, and place the binary on your PATH.

Platform Archive
Linux x86_64 spectatui-*-x86_64-unknown-linux-gnu.tar.gz
Linux aarch64 spectatui-*-aarch64-unknown-linux-gnu.tar.gz
macOS Intel spectatui-*-x86_64-apple-darwin.tar.gz
macOS Apple Silicon spectatui-*-aarch64-apple-darwin.tar.gz
Windows x86_64 spectatui-*-x86_64-pc-windows-msvc.zip
Verifying release provenance

Every release binary carries a GitHub Artifact Attestation proving it was built by this repo's release.yml workflow from the corresponding tagged commit. Verify a downloaded archive with the GitHub CLI:

gh attestation verify spectatui-v1.0.0-x86_64-unknown-linux-gnu.tar.gz --owner tinesoft
Cargo (all platforms)
cargo install spectatui
Build from source
git clone https://github.com/tinesoft/spectatui.git
cd spectatui
cargo build --release -p spectatui
# Binary is at: dist/target/spectatui/release/spectatui

πŸš€ Usage

spectatui [OPTIONS]

Options:
  -p, --project <PATH>   Path to the Spec-Kit project root [default: .]
      --theme <THEME>    Override theme: dark or light
      --accent <ACCENT>  Override accent: indigo, teal, or amber
  -h, --help             Print help

Key bindings

Global (active on every screen):

Key Action
t Toggle dark / light theme
T Cycle accent (Indigo β†’ Teal β†’ Amber)
: or Ctrl-K Open command palette
? Open help
i Open Integrations popup
f Open Features popup
w Open Workflows popup
c Open Catalogs popup
q Quit (with confirm)
Ctrl-C Force quit

Dashboard:

Key Action
1 / 2 / 3 / 4 Switch layout (Overview / Coding / Audit / Custom)
Tab / Shift-Tab Cycle pane focus
↑ / k Β· ↓ / j Navigate feature list
Enter Open Spec browser for selected feature
e Open Extensions & Presets popup
p Open Presets popup
s Open Settings
C Open Constitution viewer
a Go to Session attach

Spec browser:

Key Action
Tab / Shift-Tab Switch document tab (Spec / Plan / Tasks / Research)
↑ / k Β· ↓ / j Scroll
← / β†’ Previous / next feature
Esc Back to Dashboard

Popups (Integrations, Extensions, Presets, Workflows):

Key Action
↑ / k Β· ↓ / j Navigate list
/ Filter
a Add
x Remove
e / d Enable / Disable
u Update
Esc Close

Catalogs popup:

Key Action
Tab / Shift-Tab Switch resource kind (Extensions/Presets/Integrations/Workflows)
↑ / k Β· ↓ / j Navigate list
a Add catalog source
x Remove catalog source
r Refresh
Esc Close

No / filter in this popup, unlike the other manager popups.

While adding a source, the input box additionally supports ←/β†’ (move cursor), Home/End, Delete (forward-delete), Ctrl-C (clear the field without closing it β€” a scoped exception to the global force-quit binding), mouse click (position the cursor), and paste (bracketed paste / clipboard). Long input scrolls horizontally to keep the cursor in view.

Settings:

Key Action
↑ / k Β· ↓ / j Navigate rows
← / β†’ or Enter Adjust value / enter edit mode
Esc Back to Dashboard

⭐️ Star History

Star History Chart

🀝 Contributing

Contributions are welcome! See CONTRIBUTING.md for development setup, git workflow, and commit conventions.


πŸ“„ License

MIT Β© 2026 Tine Kondo

About

A TUI (Terminal UI) dashboard for Github Spec-Kit

Topics

Resources

Contributing

Stars

74 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages