GitVibe Wiki

GitVibe turns GitHub issues, discussions, labels, Actions, and pull requests into a maintainer-gated AI development pipeline.

Use this wiki by task. Setup details live in one place, configuration details live in one place, and workflow pages link back to those references instead of duplicating tables.

Start Here

Need	Page
Follow the practical setup path	Quick Start
Check prerequisites before setup	Setup Requirements
Configure repository features, secrets, variables, AI bundle, and App installation	Repository Settings
Operate the hosted app server, Docker runtime, public URL, and GitHub App webhooks	App Server Settings
Configure `.github/git-vibe.yml`, AI profiles, stage routing, and tests	Configuration
Learn the `/git-vibe` commands and labels	Commands and Labels
Understand bug, feature, implementation, and PR review flows	Workflows and Lifecycle
Scope tokens and understand trust boundaries	Security and Permissions
Run, monitor, and troubleshoot the app server	Operations and Troubleshooting
Read developer architecture and internals	Architecture
Understand AI context, stage schemas, adapters, and tools	AI and Stage Contracts
Work on GitVibe itself	Development and Testing

Endpoint Quick Reference

Purpose	Hosted URL
GitHub App installation	`https://github.com/apps/gitvibe-for-github`
GitHub webhook	`https://git-vibe.markhuang.ai/webhooks`
Health check	`https://git-vibe.markhuang.ai/health`

Repository owners install the hosted GitHub App. App runtime and webhook setup details are for GitVibe service operators and live in App Server Settings.

Reader Paths

Reader	Start here	Then read
First-time repository owner	Quick Start	Repository Settings, Security and Permissions
Repository maintainer	Commands and Labels	Workflows and Lifecycle
App operator	App Server Settings	Operations and Troubleshooting
Developer	Architecture	AI and Stage Contracts, Development and Testing

System Map

flowchart LR
  GH[GitHub issues, discussions, PRs] --> App[Hosted GitVibe app server]
  App -->|verify webhook signature| App
  App -->|check actor permission| API[GitHub API]
  App -->|dispatch workflow| WF[Reusable GitVibe workflow]
  WF --> Runner[GitHub Actions runner]
  Runner --> AI[Configured AI adapter]
  Runner --> Repo[Repository checkout]
  Runner -->|comments, labels, issues, PR reviews| GH
  Maintainer[Admin or collaborator] -->|labels, reviews, commands| GH
  Human[Human reviewer] -->|review and merge| GH

GitVibe does not auto-merge pull requests or let AI authorize work. Trusted repository actors control commands, protected labels, approval, review, and merge decisions.

Canonical References

Setup checklist: Setup Requirements
Repository settings, secrets, and variables: Repository Settings
Hosted app runtime, Docker, and webhooks: App Server Settings
.github/git-vibe.yml: Configuration
Commands and managed labels: Commands and Labels
GitHub App permissions and security boundaries: Security and Permissions
Stage targets, schemas, tools, and next states: AI and Stage Contracts

The wiki is the canonical long-form documentation source for GitVibe. The implementation lives in ../git-vibe, including src/app, src/runner, src/shared, .github/workflows, examples/consumer, packages/git-vibe-setup, prompts, schemas, and composite actions.