@tmidev/hyper-cli
v0.1.0
Published
Interactive TUI for viewing Hyper tasks and dependencies
Maintainers
Readme
@tmidev/hyper-cli
Interactive TUI for viewing Hyper features, tasks, and dependencies.
Features
- Feature List View: Browse all Hyper features with List or Kanban layout
- Status indicators with colors (planning, approved, executing, completed)
- Sort features by status
- Switch between List and Kanban view with
vkey
- Feature Details Split View: Tasks tree + Plan preview side-by-side
- Dependency tree visualization showing task prerequisites
- Real-time plan.md scrollable preview
- Tab switching between panels
- Task Details: View individual task status, metadata, and spec
- Dependency Graph: Wave-based execution visualization
- ASCII flow diagram showing execution order
- Status icons and colors per task
- Auto-Refresh: File watcher updates UI when
.hyper/changes - Fullscreen Mode: Uses full terminal dimensions
Installation
# Run directly with npx
npx @tmidev/hyper-cli
# Or install globally
npm install -g @tmidev/hyper-cli
hyper-tuiUsage
Run in a directory containing a .hyper/ folder:
hyper-tuiThe TUI will display your Hyper features and allow you to navigate tasks and dependencies.
Keyboard Shortcuts
Feature List View
| Key | Action | | ------- | ----------------------- | | j/↓ | Move down | | k/↑ | Move up | | Enter | Open feature | | v | Toggle List/Kanban | | Tab/←/→ | Switch columns (Kanban) | | r | Refresh | | q | Quit | | ? | Toggle help |
Feature Details View
| Key | Action | | ----- | ------------------ | | j/↓ | Move down in panel | | k/↑ | Move up in panel | | Tab | Switch panel | | Enter | View task details | | t | Full task list | | d | Dependency graph | | q | Back to features | | ? | Toggle help |
Plan/Task/Graph Views
| Key | Action | | ---- | ----------- | | j/↓ | Scroll down | | k/↑ | Scroll up | | PgDn | Page down | | PgUp | Page up | | q | Back |
Requirements
- Node.js 18+ or Bun
- A project with
.hyper/folder (created by Hyper workflow tools) - Terminal with 256-color support recommended
Tech Stack
- Ink v6 - React for CLI
- React v19
- hyper-core - Hyper service layer
Related
- @tmidev/hyper-opencode - OpenCode plugin for Hyper workflow
License
MIT
