Git With Intent

v0.10.0 — AI-powered CLI for PR automation with approval gating

1 — At a Glance
9
Apps
8
Packages
8
AI Agents
5
Cloud Run Services
20
ARV Gates

GWI automates the boring parts of pull requests. Merge conflict resolution, code review, issue-to-code generation, complexity scoring — with approval gating so nothing ships without your explicit say-so. Every destructive operation is hash-bound: if the patch changes after you approve, the approval is invalidated.

Quick Start
npm install && npm run build export ANTHROPIC_API_KEY="..." gwi autopilot <pr-url>
2 — Why GWI

Every team has the same bottlenecks. Merge conflicts that take an hour to untangle. PRs sitting in review queues. GitHub issues that could be a working PR in minutes if someone would just write the code.

Copilot helps you write code in your editor. GWI operates at the repo level — it reads the issue, generates a branch, writes the code, opens the PR, and waits for you to approve. Or it resolves conflicts that have been blocking your PR for a week. Or it reviews your local changes before you even push.

Local review (gwi review --local) works without any API key — it's deterministic static analysis. No cost, no latency, no secrets required.

3 — How It’s Different
ToolWhat It DoesGWI Difference
GitHub CopilotSuggests code in editorGenerates PRs from issues, resolves conflicts at repo level
Cursor / WindsurfAI coding assistantsRepo-level automation, not editor plugins
Linear / JiraProject managementActually writes the code from issue descriptions
SonarQubeStatic analysisFixes issues, not just reports them
DependabotDependency updatesFull semantic conflict resolution, not just bumps
4 — Architecture
5 — Agent Routing

Simple tasks route to fast/cheap models. Complex tasks escalate to powerful ones. A PR scoring 3/10 uses Gemini Flash. One scoring 8/10 gets Claude Opus.

AgentModelPurposeComplexity
OrchestratorGemini FlashWorkflow coordination○ 1-10
TriageGemini FlashFast complexity scoring● 1-3
CoderClaude Sonnet/OpusCode generation◆ 4-10
ResolverClaude Sonnet/OpusConflict resolution◆ 4-10
ReviewerClaude SonnetReview summaries◆ 3-7
ForemanCoordinatorWorkflow management○ all
Slop DetectorQuality gateCatches low-quality output◆ all
InfraInfrastructureDeployment operations◆ all
6 — CLI Commands
CommandWhat It DoesNeeds API Key?
gwi triage <url>Score PR complexity 1-10● Yes
gwi resolve <url>Resolve merge conflicts semantically● Yes
gwi review <url>Generate review summary● Yes
gwi review --localDeterministic local review○ No
gwi review --local --aiAI-powered local review● Yes
gwi issue-to-code <url>Create a PR from a GitHub issue● Yes
gwi autopilot <url>Full pipeline: triage, resolve, review, approve● Yes
gwi gatePre-commit approval gate○ No
gwi triage --diff HEAD~3Score complexity of recent commits○ No
gwi explain <id>Explain AI decisions for a run○ No
gwi run listList recent runs○ No
gwi run approve <id>Approve pending changes○ No
7 — Approval & Security
Safe (No Approval)
  • Read repo data
  • Analyze patterns & complexity
  • Generate patches
  • Post review comments
Approval Required (Hash-Bound)
  • Commit changes
  • Push to remote
  • Merge pull requests
  • Delete branches
Hash binding: If the patch changes after approval, the approval is invalidated. Every agent has a SPIFFE ID for identity. Full audit trail at .gwi/runs/<runId>/audit.log.
8 — Deployment

Five Cloud Run services, all scale-to-zero (no traffic = no cost). Infrastructure managed by OpenTofu. Deploys via GitHub Actions only.

ServicePurposeRuntime
gwi-apiREST API○ Cloud Run
gwi-gatewayAgent-to-agent coordination○ Cloud Run
gwi-webhookGitHub webhook handler○ Cloud Run
gwi-workerBackground jobs○ Cloud Run
gwi-mcp-serverMCP tool server○ Cloud Run
FirestoreOperational database◆ Managed
Firebase HostingWeb dashboard◆ Managed
9 — Monorepo Structure
View full monorepo structure
Apps (9)
  • cli gwi command
  • api REST API
  • gateway A2A coordination
  • github-webhook webhook handler
  • mcp-server MCP tools
  • webhook-receiver generic webhooks
  • worker background jobs
  • registry workflow templates
  • web React dashboard
Packages (8)
  • core storage, billing, security
  • agents AI implementations
  • engine workflow orchestration
  • integrations GitHub connector
  • connectors data connectors
  • forecasting TimeGPT
  • sandbox secure execution
  • sdk TypeScript SDK
Infrastructure
  • infra/ OpenTofu (22 .tf files)
  • .github/ CI/CD workflows
  • scripts/arv/ 20 readiness gates
  • test/ contracts, goldens, e2e
  • 000-docs/ internal documentation
10 — Get Started