pw_ghish#

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

Experimental Go

  • Familiar GitHub CLI interface: Seamlessly interact with Gerrit code reviews and LUCI CI checks using standard gh pr command syntax.

  • Unlocks parametric agent knowledge: AI coding agents pre-trained on the GitHub CLI can review, comment, push, and submit changes without custom prompting.

  • Autonomous CI driving & agentic polling: Eliminates human context switching by enabling AI agents to watch, poll, extract step failure logs, and drive changes to ground without human intervention.

  • Zero-setup repository wrapper: Instant execution via ./gh with automatic per-commit compilation and caching.

  • Pigweed CI & review integration: First-class support for Pigweed auto-submit, Commit-Queue, and LUCI tryjobs.

  • Multi-project support: Pluggable profiles and standalone binary distribution for Fuchsia and generic Gerrit projects.

pw_ghish (invoked via the ./gh wrapper at the repository root) provides GitHub CLI (gh pr) ergonomics on top of Gerrit code review and LUCI CI infrastructure.

Warning

pw_ghish is currently validated and production-ready only for upstream Pigweed. While foundational profile infrastructure for other projects exists, multi-project decoupling and non-Pigweed CI workflows are under active development. See the Status & roadmap page for current status, feature availability, and upcoming milestones.

Quick reference#

Run the ./gh repository wrapper from anywhere in your Pigweed checkout:

# View review dashboard for active branch & your open CLs:
$ ./gh pr status

# Push a new patchset on the current branch to Gerrit:
$ ./gh pr push

# Check live status and duration of LUCI tryjob builders:
$ ./gh pr checks

# View failure summaries and step log snippets in the terminal:
$ ./gh run view --log-failed

# Reply to an inline comment thread and mark as resolved:
$ ./gh pr comment --path <file> --line <line> -m "Done." --resolved

# Enable automated submission once review and CI checks pass:
$ ./gh pr merge --auto

Documentation#

CLI User Guide

Subcommand reference and examples for viewing, pushing, reviewing, commenting, inspecting CI, and merging.

CLI User Guide
AI Workflows

Workflows for AI pair programming: private draft steering, staged review replies, CL handoffs, and CI failure triage.

AI Workflows
GitHub CLI Comparison

Command comparison with GitHub CLI (gh), flag mapping, and architectural differences in Gerrit.

GitHub CLI Comparison
Status & Roadmap

Operational status, upstream Pigweed focus, and roadmap for multi-project decoupling, SCM exploration, setup automation, and hooks.

Status & roadmap
Project Adoption Guide

Installing standalone binaries, setting up repository wrappers, configuring project profiles, and authentication.

Project Adoption Guide
Flag Compatibility Policy

Compatibility principles with upstream GitHub CLI, compatibility tiers, and ghish-only flag designations.

Flag compatibility policy
Agent Evaluation Runbook

Verification runbook for coding agents, behavioral rubric, and live integration test suite.

Agent Evaluation Runbook