Subcommands#

pw_ghish: GitHub CLI-like interface for Gerrit code reviews and CI checks

pw_ghish (invoked via ./gh) organizes its commands by the backend service or local resource they manage. Each subcommand page documents the available commands, flags, and differences from upstream GitHub CLI (gh).

Command families#

Subcommand

Upstream gh Target

pw_ghish Target

Summary & Reference

gh pr

GitHub Pull Requests

Gerrit Change Lists (CLs)

Create and push patchsets, vote Commit-Queue / Auto-Submit, edit commit trailers, reply to inline threads, and submit changes.

gh run & pr checks

GitHub Actions Runs & Checks

LUCI Buildbucket & Recipes

Watch blocking tryjobs, inspect recipe step trees, fetch step failure logs, and rerun builders via bb add.

gh issue

GitHub Issues

Google Issue Tracker (Buganizer)

Triage queues, create issues with Bug: b/<id> commit trailers, apply structured priority/severity/type labels, and close bugs.

gh auth

GitHub Host Authentication

Gerrit, LUCI & Buganizer Auth

Check credentials across Gerrit, LUCI Buildbucket, and Buganizer in googler and community modes.

gh hook

(None — gh-ish extension)

Agent Tool Guards & Git Hooks

Install and run coding agent PreToolUse guards and Gerrit commit-msg / pre-push Git hooks.

gh wt

(None — gh-ish extension)

Git Worktrees & Bazel Cache Pool

Allocate warm physical build slots (pw-01..N), manage project symlinks, and sync Antigravity (Jetski) IDE workspaces.

Root-level aliases and global flags#

For common operations, ./gh provides top-level aliases and global flags:

  • Root aliases:

    • ./gh push (alias for ./gh pr push)

    • ./gh status (alias for ./gh pr status)

    • ./gh view (alias for ./gh pr view)

    • ./gh diff (alias for ./gh pr diff)

    • ./gh checks (alias for ./gh pr checks)

    • ./gh worktree (alias for ./gh wt)

    • ./gh agent (alias for ./gh hook)

  • Global flags:

    • --host <domain>: Override the target Gerrit host.

    • --profile <name>: Force the pigweed, fuchsia, or generic project profile.

    • --auth-mode <mode>: Set the authentication mode (auto, googler, community, or none). See Authentication modes.

    • -v, --verbose: Enable debug logging.