Terminal UI
nspec includes two interactive terminal UIs built with Textual.
nspec tui # Standard table view
nspec ngtui # Next-gen accordion view with collapsible epic panels
Features
- Spec Table — Multi-column sortable display with epic filtering
- Detail Panel — Full spec metadata, tasks, and acceptance criteria
- Real-time Search — Filter with
/, navigate matches with n/N
- Epic Filtering — Press
e to filter by epic
- Status/Priority Filtering — Press
S, P, or B to filter by status, priority, or blocked state
- Follow Mode — Auto-tracks the currently active spec (
f)
- Compact Mode — Condensed table layout (
b)
- View Cycling — Switch between table and panel layouts (
v)
- Validation Errors — Press
! to view validation errors
- Live Reload — Watches docs directory and refreshes on changes
- Activity Heatmap — GitHub-style commit calendar in reports view
Keybindings
Navigation
| Key |
Action |
j / ↓ |
Move down |
k / ↑ |
Move up |
G |
Jump to last row |
gg |
Jump to first row |
Enter |
Open detail view |
Escape |
Back / close / clear search |
q |
Quit |
Search
| Key |
Action |
/ |
Open search |
n |
Next match |
N |
Previous match |
Display
| Key |
Action |
v |
Cycle view mode |
p |
Toggle detail panel |
b |
Toggle compact mode |
o |
Cycle sort column |
O |
Reverse sort order |
r |
Refresh data |
Filtering
| Key |
Action |
e |
Set epic filter |
S |
Filter by status |
P |
Filter by priority |
B |
Filter blocked specs |
c |
Hide completed/superseded specs |
C |
Clear all filters |
Actions
| Key |
Action |
a |
Toggle activate spec |
m |
Move spec to another epic |
f |
Toggle follow mode (auto-track active spec) |
s |
Show reports (metrics, heatmap) |
h |
Show help |
! |
Show validation errors |
? |
Toggle extended footer |
: |
Open command modal |
Command Modal
Press : to open the command modal. Type commands to interact with specs directly from the TUI.
Engineering Metrics
Press s to access the engineering metrics dashboard:
- Velocity — Commits, LOC, active days, specs completed per period
- Quality — Test coverage, lint issues, cyclomatic complexity, maintainability index
- DORA Metrics — Spec velocity tier, quality gate pass rate, change failure rate
- Activity Heatmap — GitHub-style commit calendar
Next-Gen TUI (ngtui)
The next-gen TUI organizes specs into collapsible accordion panels grouped by epic. Each epic panel shows its specs with inline progress indicators.