Isolated Git workspaces for AI coding agents

  ____                                      __
 / ___|_ __ _____   _____ _   _  __ _ _ __ __| |
| |  _| '__/ _ \ \ / / _ \ | | |/ _` | '__/ _` |
| |_| | | | (_) \ V /  __/ |_| | (_| | | | (_| |
 \____|_|  \___/ \_/ \___|\__, |\__,_|_|  \__,_|
                          |___/  ____                                      __
 / ___|_ __ _____   _____ _   _  __ _ _ __ __| |
| |  _| '__/ _ \ \ / / _ \ | | |/ _` | '__/ _` |
| |_| | | | (_) \ V /  __/ |_| | (_| | | | (_| |
 \____|_|  \___/ \_/ \___|\__, |\__,_|_|  \__,_|
                          |___/  ____                                      __
 / ___|_ __ _____   _____ _   _  __ _ _ __ __| |
| |  _| '__/ _ \ \ / / _ \ | | |/ _` | '__/ _` |
| |_| | | | (_) \ V /  __/ |_| | (_| | | | (_| |
 \____|_|  \___/ \_/ \___|\__, |\__,_|_|  \__,_|
                          |___/

Safe, disposable Git workspaces for coding agents.

Setup

Run the latest Groveyard release from the repository where your coding agent works. Groveyard detects your coding app, configures its MCP connection and native instructions, then verifies that everything is ready.

npx -y @groveyard/mcp@latest setup

$ npx -y @groveyard/mcp@latest setup
✓ Found repository
✓ Detected coding app
✓ Installed Groveyard MCP
✓ Added agent instructions
✓ Verified connection

Groveyard is ready. Restart your coding app, then give your agent a task.

Works with your coding app

Groveyard supports Codex, Claude Code, VS Code/Copilot, Cursor, Gemini CLI, OpenCode, Claude Desktop, and other MCP clients.

Usage

Ask your agent to make a change. Groveyard creates or adopts an isolated workspace, keeps your main checkout clean, and validates the handoff.

You:
Fix the authentication timeout. Run the tests.

Agent:
✓ Groveyard session started
✓ Working in an isolated workspace
✓ Validation passed
✓ Changes ready to merge

A complete task lifecycle

Start a session, work inside the returned workspace, validate the result, then finish or clean up when the task is done.

start_session  →  session_status  →  validate_session
finish_session →  cleanup_session

  ____                                      __
 / ___|_ __ _____   _____ _   _  __ _ _ __ __| |
| |  _| '__/ _ \ \ / / _ \ | | |/ _` | '__/ _` |
| |_| | | | (_) \ V /  __/ |_| | (_| | | | (_| |
 \____|_|  \___/ \_/ \___|\__, |\__,_|_|  \__,_|
                          |___/  ____                                      __
 / ___|_ __ _____   _____ _   _  __ _ _ __ __| |
| |  _| '__/ _ \ \ / / _ \ | | |/ _` | '__/ _` |
| |_| | | | (_) \ V /  __/ |_| | (_| | | | (_| |
 \____|_|  \___/ \_/ \___|\__, |\__,_|_|  \__,_|
                          |___/  ____                                      __
 / ___|_ __ _____   _____ _   _  __ _ _ __ __| |
| |  _| '__/ _ \ \ / / _ \ | | |/ _` | '__/ _` |
| |_| | | | (_) \ V /  __/ |_| | (_| | | | (_| |
 \____|_|  \___/ \_/ \___|\__, |\__,_|_|  \__,_|
                          |___/