Guide - GitHub CLI (gh) on Omarchy

GitHub CLI (gh) is pre-installed on Omarchy and authenticated to the always-coding GitHub account. This guide covers how gh fits into the Omarchy development workflow.

Version

gh version 2.92.0 (2026-04-28)

Authentication

The gh CLI is authenticated via the system keyring against github.com with the scopes: gist, read:org, repo, workflow.

gh auth status           # Verify auth
gh auth login            # Re-authenticate if needed

Core workflows

The gh command is the primary interface for GitHub operations — issues, pull requests, releases, gists, and Actions. No Omarchy-specific wrapper exists; the raw gh CLI is used directly.

Issues

gh issue list                  # Open issues in current repo
gh issue list --assignee @me   # Issues assigned to you
gh issue create                # New issue (opens editor)
gh issue view 123              # View issue details
gh issue view 123 --comments   # Show comments
gh issue close 123             # Close an issue
gh issue reopen 123            # Re-open an issue

Pull requests

gh pr list                     # Open PRs
gh pr list --state merged      # Recently merged
gh pr create                   # New PR (opens editor)
gh pr checkout 321             # Check out PR locally
gh pr view 321                 # View PR details
gh pr view 321 --web           # Open in browser
gh pr diff                     # Show PR diff
gh pr review 321 --approve     # Approve
gh pr review 321 --request-changes  # Request changes
gh pr merge 321                # Merge PR

Repos

gh repo clone owner/repo       # Clone a repo
gh repo create my-repo         # Create new repo
gh repo fork                   # Fork current repo
gh repo view                   # View repo info
gh repo view --web             # Open repo in browser

Gists

gh gist list                   # List gists
gh gist create file.txt        # Create gist from file
gh gist create -d "Desc" file.txt  # Gist with description
gh gist view <id>              # View gist

Releases

gh release list                # List releases
gh release create v1.0        # Create release
gh release download v1.0      # Download release assets

Actions

gh run list                    # Recent workflow runs
gh run view                    # Details of latest run
gh run watch                   # Watch latest run in real-time
gh workflow list               # List workflows
gh workflow run <name>         # Trigger workflow

gh search repos "topic:hyprland omarchy"   # Search repositories
gh search issues "bug" --repo owner/repo   # Search issues
gh search prs "state:open" --repo owner/repo  # Search PRs

Status

gh status                      # Overview of relevant PRs, issues, and
                               # notifications across your repos

Integration with Omarchy

Editor

The gh CLI respects $EDITOR for issue/PR descriptions. On Omarchy this is typically your configured editor:

echo $EDITOR                   # Check which editor gh will use

If you use a terminal editor (Helix, Neovim), gh will open it inline. For GUI editors (VS Code, Zed), gh opens a separate window.

Keybindings

No default Omarchy keybinding invokes gh directly. You can add one in ~/.config/hypr/bindings.conf:

bind = SUPER SHIFT, G, exec, xdg-terminal-exec gh status

This opens a terminal with gh status — a quick overview of your open PRs, issues assigned to you, and unread notifications.

Terminal

Omarchy uses Alacritty (or Foot, Kitty, Ghostty). The gh CLI works in any of them. For long-running operations (e.g., gh run watch), you may want a dedicated tmux pane:

Prefix h          # Split pane (below)
Prefix v          # Split pane (right)

See the tmux cheatsheet for more.

Shell completion

gh completion -s zsh > /usr/local/share/zsh/site-functions/_gh
exec zsh

If using oh-my-zsh or zinit, the gh plugin typically handles this.

Tips

  • Use gh pr create --fill to auto-populate title/body from commit messages.
  • Use gh pr checkout to quickly switch to PR branches without fetching manually.
  • Use gh issue view 123 --json title,body,comments --jq for scripting.
  • Pair gh with jq for automation: gh issue list --json number,title | jq
  • The --web flag on browse, issue, pr, release, and repo commands opens the browser — useful with Omarchy's default Hyprland setup.
  • Run gh help environment to see all configurable environment variables.