nightgauge

Nightgauge

AI-powered Issue-to-PR pipeline with enforced quality gates.

Nightgauge transforms how teams build software by guiding AI agents through a structured development workflow—from issue creation to merged pull request. Every step enforces documentation-first practices, acceptance criteria validation, and automated quality checks.

Open-source and local-first

Everything in this repository is Apache-2.0 licensed. The VS Code extension, SDK, portable skills, Claude plugin, and Go binary run locally using model and forge credentials you control. No Nightgauge account or hosted service is required, cloud connectivity is disabled by default, and telemetry is opt-in.

Optional services may integrate through public contracts, but their private implementations and commercial plans are outside this repository. See VISION.md and docs/PRODUCT_OVERVIEW.md.

Prerequisites

Have these in place before installing — the pipeline orchestrates tools you already use rather than replacing them:

Requirement	Needed for
Claude Code (or another supported adapter)	Stage execution — bring your own subscription/keys; nothing is proxied
git + gh CLI (authenticated)	Branching, PRs, issue operations
A GitHub repository with issues	The pipeline's unit of work
GitHub Projects v2 board (+ .nightgauge/config.yaml pointing at it)	The autonomous scheduler and board-driven views — without a board you can still run single issues manually
Node.js ≥ 24 (pinned in .nvmrc)	VSCode extension and SDK builds

Platform support: macOS is the primary end-to-end tested platform. Packaged Linux amd64 CLI and VSIX binaries are tested on Debian and Alpine; live provider-driven Linux pipelines still have less coverage. Windows is not currently supported; use WSL2.

Install from Source

git clone https://github.com/nightgauge/nightgauge.git
cd nightgauge
go install ./cmd/nightgauge

Signed release binaries, checksums, and the Homebrew cask will be available with the first public release. Until then, build from the reviewed source tree. See docs/GO_BINARY.md for the full install matrix and details on each method.

Quick Start

VSCode Extension (Recommended UI)

The full Nightgauge experience with visual dashboard, project board integration, batch processing, and one-click pipeline execution.

Before the first production release, use a target-specific VSIX from a reviewed GitHub Actions release-candidate run. After v0.2.0, download the VSIX matching your OS/architecture from the GitHub Release and install it with Extensions → … → Install from VSIX. Building locally or running dev-install.sh is for extension development and intentionally produces a non-release build.

Not yet on the VS Code Marketplace — a Marketplace listing is planned as its own follow-up release.

Features:

• Visual pipeline status with real-time progress
• GitHub Project board integration (Ready/In Progress/In Review views)
• Batch pipeline execution for multiple issues
• Token usage tracking and cost analytics
• Configurable notifications and sounds

Claude Code CLI (Alternative)

For terminal-based workflows, install the Nightgauge plugin:

# Add the marketplace
claude plugin marketplace add https://github.com/nightgauge/nightgauge.git

# Install the Nightgauge plugin
claude plugin install nightgauge@nightgauge-plugins

# Start the pipeline
/nightgauge:issue-pickup

OpenAI Codex CLI (Beta Adapter)

Codex support is available through both slash commands and the unified stage runner.

Install Codex assets (commands + skills):

./scripts/install-agent-skills.sh --codex-only

Slash commands are defined in .codex/commands/ and invoked as /<name>: