stacklok / toolhive / 25052753903

66%

Build Type

push

github

Committed by web-flow

Commit Message

Add interactive TUI dashboard for managing MCP servers (#4680)

* Add interactive TUI dashboard

Add a terminal dashboard (thv tui) for managing MCP servers with:
- Real-time workload list with status indicators and filtering
- Tabbed panels for logs, server info, tools, proxy logs, and inspector
- Tool inspector with form-based calling and JSON tree response viewer
- Registry browser with search and detail view
- Log search with case-insensitive highlighting and match navigation
- Horizontal scrolling for long log lines
- Keyboard-driven navigation with contextual help overlay

The codebase is organized into focused files by area (inspector,
registry, search, navigation) with shared form field helpers and
sub-structs for clean state management.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Add run from registry support in TUI

Allow launching MCP servers directly from the registry browser. Press
'r' in the registry detail view to open a form with the workload name
and environment variable fields pre-populated from registry metadata.
Secret fields use password masking. On submit, the TUI spawns
'thv run' as a subprocess and refreshes the workload list on completion.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Cap tool description to 2 lines in inspector

Truncate long tool descriptions in the inspector form to 2 lines with
an ellipsis and [i] hint to view the full text in the detail modal.
This prevents verbose MCP tool descriptions from pushing form fields
off screen.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Sort environment variables in info panel

Sort environment variable keys alphabetically before rendering in the
server info panel. Go maps have non-deterministic iteration order,
which caused env vars to shuffle on every 5-second refresh cycle.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Add unit tests for TUI pure functions

Cover... (continued)

Coverage Stats

430 of 4078 new or added lines in 30 files covered. (10.54%)

42 existing lines in 7 files now uncovered.

60214 of 94171 relevant lines covered (63.94%)

57.84 hits per line