Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -77,6 +77,7 @@ Every command reads from `src/core/config.ts`, which resolves values in this ord
- **Proxy Passthrough** — pass any unrecognized command directly to the `gh` CLI
- **Structured JSON Output** — every command supports machine-parseable JSON via `--json`
- **Terminal Themes** — built-in dark, light, and auto color themes via `--theme`
- **Full Terminal UI** — browse and run the full `ghg` workflow surface from `ghg tui`

---

Expand Down Expand Up @@ -152,6 +153,7 @@ When a profile is active, all API calls use that profile's token. The `detect` c
### Notifications

```bash
ghg tui # Launch full-screen terminal UI.
ghg notifications list # List unread notifications.
ghg notifications read <id> # Mark as read.
ghg notifications done <id> # Mark as done.
Expand Down Expand Up @@ -255,6 +257,7 @@ ghg proxy <args> # Pass any args to the gh CLI.
### Utility

```bash
ghg tui # Launch full-screen terminal UI.
ghg ping # Check if the CLI is working.
ghg version # Show version number.
```
Expand Down
27 changes: 17 additions & 10 deletions ROADMAP.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,20 +2,27 @@

---

## v2.8.0 — Interactive TUI Mode
## v2.8.0 — Full Terminal UI

**Why gh doesn't have it:** `gh` outputs flat text only. Extension `ghdash` (very popular) proves massive demand for a rich terminal UI, but it's external and limited.
**Why gh doesn't have it:** `gh` is command-first and outputs flat text. External tools like `ghdash` prove demand for rich terminal dashboards, but they cover only part of the GitHub workflow. `ghg` can make its whole feature set browsable, actionable, and keyboard-driven from one terminal-native interface.

**Commands:**

- `ghg tui` — launch full screen terminal UI
- Browse PRs/issues with keyboard navigation (vim bindings)
- View diffs with syntax highlighting in terminal
- Inline comment and approve without leaving TUI
- Filterable, sortable tables with live refresh
- Split pane view: PR list on left, diff on right

**Value:** A terminal native GitHub dashboard that doesn't break flow. Developers who live in tmux/neovim will never leave the terminal.
- `ghg tui` — launch the full-screen terminal UI
- Dashboard home for notifications, mentions, activity, PRs, workflows, repository health, and active profile
- Command palette for every major `ghg` workflow without memorizing subcommands
- Keyboard-first navigation with vim-style bindings, tabs, search, filters, and sortable tables
- Notification and mention triage: open, mark read, mark done, jump to related PR/issue/repo
- PR and review workspace: list PRs, inspect metadata, open threads, resolve threads, create comments, approve/request changes through existing review flows
- Repository workspace: inspect, govern, label, retire, and report across configured repository targets
- Labels workspace: pull, push, prune, compare templates, and preview sync impact
- Insights workspace: traffic, contributors, commits, frequency, popularity, and participation views
- Workflow/run workspace: validate workflows, preview generated workflows, debug failed runs, and surface logs/status summaries
- Profile/config workspace: view active profile, switch profiles, detect local profile, and edit common settings
- Action details pane with human-readable summaries plus an explicit JSON preview/export path where relevant
- Lightweight file, comment, and status previews; rich next-generation diff review remains a separate future milestone

**Value:** Turns `ghg` from a set of powerful commands into a terminal-native GitHub cockpit. Users can discover and run the full product surface from one keyboard-driven UI while preserving scriptable CLI commands and explicit `--json` output.

---

Expand Down
Loading