How jgorodetsky/ghh works
ghh is a shell-based, searchable command center for Git and GitHub workflows, with a separate interactive conventional-commit command. The main workflow is to invoke ghh, optionally pre-filter its menu, choose a command, complete any guided prompts or pickers, pass its risk checks, and run it. The README documents broad Git, PR, CI, issue, worktree, and release capabilities. Runtime source was not sampled, so subsystem paths use the existing bin/ghh file and uncertain internal wiring is omitted.
Main entry points: ghh Risk checks
Components 25
Command menu
- ghh entry
bin/ghh - Command catalog
bin/ghh - Menu filtering
bin/ghh - Fuzzy menu
bin/ghh - Risk checks
bin/ghh - Guided pickers
bin/ghh - Custom commands
bin/ghh - Recent commands
bin/ghh
Git workflows
- Git operations
bin/ghh - Diff and review
bin/ghh - Branch and worktrees
bin/ghh - Commit builder
bin/ghh
GitHub workflows
- PR workflows
bin/ghh - CI and checks
bin/ghh - Issues and search
bin/ghh - Tags and releases
bin/ghh
Shell support
- Pick/query state
Other components
- User
- git
- GitHub CLI
- fzf
- Shell history
- Web browser
- Shell
- Platform services
Connections 33
- User → ghh entry: invokes
- ghh entry → Command catalog: loads
- ghh entry → Menu filtering: passes query
- ghh entry → Fuzzy menu: opens
- Command catalog → Custom commands: includes
- Custom commands → Shell: reads config
- Fuzzy menu → fzf: queries
- Fuzzy menu → Risk checks: selects command
- Fuzzy menu → Recent commands: ranks commands
- Recent commands → Pick/query state: reads history
- Recent commands → Pick/query state: writes history
- Risk checks → Guided pickers: dispatches guided commands
- Risk checks → Git operations: dispatches
- Risk checks → Diff and review: dispatches
- Risk checks → Branch and worktrees: dispatches
- Risk checks → Commit builder: dispatches
- Risk checks → PR workflows: dispatches
- Risk checks → CI and checks: dispatches
- Risk checks → Issues and search: dispatches
- Risk checks → Tags and releases: dispatches
- Git operations → git: runs
- Diff and review → git: runs
- Branch and worktrees → git: runs
- Commit builder → git: commits with
- PR workflows → GitHub CLI: runs
- CI and checks → GitHub CLI: runs
- Issues and search → GitHub CLI: runs
- Tags and releases → git: runs tag commands
- Tags and releases → GitHub CLI: runs release commands
- ghh entry → Shell history: records commands
- CI and checks → Web browser: opens check
- ghh entry → Platform services: detects clipboard and browser
- ghh entry → Shell: integrates with