Galley
Galley is a local runtime for supervised, multi-model AI coding. It lets you choose an executor and a supervisor independently, defines acceptance criteria and repository policy, runs work in an isolated git worktree, and records each attempt for later inspection. It is for developers who want to use lower-cost or specialized models for implementation while keeping human review in the loop.
✨ Key features
- Explicit model configuration for executor and supervisor.
- Repository-defined standards via quality and environment profiles.
- Focused retries with supervisor review and regression risk focus.
- Auditable execution with evidence stored under workflow root.
- Isolated AFK work in managed git worktree with retry limits.
- Review-ready handoff by opening pull requests for human review.
🎯 Use cases
- Automate small bug fixes or test improvements in a repository.
- Run multi-model AI coding tasks with separate executor and supervisor.
- Queue tasks for unattended execution in isolated worktrees.
- Maintain auditable records of AI coding attempts for review.
📦 Installation
🧰 Requirements: Requires a supported provider CLI (Claude, Codex, or Grok) and optionally API keys for GLM or Kimi; works on macOS, Linux, and Windows.
curl -fsSL https://raw.githubusercontent.com/shinpr/galley/main/scripts/install.sh | sh
Windows PowerShell:
Invoke-WebRequest https://raw.githubusercontent.com/shinpr/galley/main/scripts/install.ps1 -OutFile install.ps1 -UseBasicParsing
powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1
Or with Go:
go install github.com/shinpr/galley/cmd/galley@latest
After installation, create the default daemon config:
galley daemon config init
🚀 Usage
galley daemon start
Then use the Galley skill in Claude Code, Codex, or Grok Build to set up a repository and queue tasks. For example, in Claude Code:
/plugin marketplace add shinpr/galley
/plugin install galley@galley-tools
/reload-plugins
/galley:galley Set up Galley for this repository.
⚠️ Good to know
Galley treats task YAML as trusted local execution input; only run it for repositories and task authors you trust, and Windows support is CI-covered but should be validated locally before relying on it for unattended work.
❓ FAQ
Which AI backends can Galley use as executors or supervisors?
Galley supports Claude, Codex, GLM, Kimi, and Grok Build as executors and supervisors. GLM and Kimi run through the Claude CLI with their respective API keys.
How does Galley ensure the main repository stays clean?
Galley runs execution in an isolated git worktree, so the source repository remains clean during task implementation.
What happens when a task is accepted?
The recommended setup commits the accepted work and opens a pull request for final human review.
Can I use Galley without the plugin skill?
Yes, you can install the CLI manually and use it directly, but the skill is recommended because it handles repository setup, task YAML drafting, and queueing correctly.
📊 Repository
🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.