Summary
Add a thv tui command that launches an interactive terminal user interface (TUI) for ToolHive, improving the overall user experience for users who prefer to manage their MCP servers directly from the terminal without relying on a separate web UI.
Background
ToolHive already provides a solid CLI experience, but some workflows — such as inspecting running servers, browsing logs, or exploring the registry — benefit from a richer, interactive interface. A TUI improves the current user experience and integrates UI-style functionality directly in the terminal, without requiring users to switch to a browser or remember individual subcommands.
Proposed Solution
Introduce a thv tui subcommand that opens an interactive terminal UI (e.g. built with Bubble Tea / Lip Gloss). The TUI should include the following views:
- Running MCP list — overview of all currently running MCP servers
- MCP detail — info panel for a selected running MCP (metadata, status, configuration)
- Logs viewer — MCP server logs and proxy logs, with in-view search/filtering
- Tools list — list of tools exposed by a running MCP, each with its description
- Registry list — browse servers available in the configured registry, with descriptions
- MCP Inspector — interactive panel to craft MCP request payloads, send them to a running MCP, read the JSON response, and copy it to the clipboard
Acceptance Criteria
Summary
Add a
thv tuicommand that launches an interactive terminal user interface (TUI) for ToolHive, improving the overall user experience for users who prefer to manage their MCP servers directly from the terminal without relying on a separate web UI.Background
ToolHive already provides a solid CLI experience, but some workflows — such as inspecting running servers, browsing logs, or exploring the registry — benefit from a richer, interactive interface. A TUI improves the current user experience and integrates UI-style functionality directly in the terminal, without requiring users to switch to a browser or remember individual subcommands.
Proposed Solution
Introduce a
thv tuisubcommand that opens an interactive terminal UI (e.g. built with Bubble Tea / Lip Gloss). The TUI should include the following views:Acceptance Criteria