A visual desktop orchestrator for Claude Code agents. Pixel-art gardeners represent real Claude Code CLI sessions working on your codebase. The app is the Head Gardener — it detects, spawns, assigns, coordinates, and monitors Claude Code agents.
- You open a project directory in Agent Garden
- The Head Gardener (orchestrator) detects running Claude Code sessions or spawns new ones
- Each Claude Code agent appears as a pixel-art gardener with a designated role (planter, weeder, tester)
- As agents work, you see their activity in real-time — speech bubbles, tool use, file edits
- The app can seed the garden from the existing repo, then keep growing it as files are created/modified
- Plants are grouped into directory-aware garden beds with visible walkways and bed-stable clustering
- An activity log records agent lifecycle, tool, plan, and file events alongside the live garden
Plants = files. Garden = codebase. Gardeners = Claude Code sessions. Head Gardener = orchestrator.
git clone https://github.com/3-rt/agent-garden.git
cd agent-garden
npm installRequires Claude Code CLI installed and configured.
npm start # Build and launch
npm run dev # Watch mode (then: npx electron . in another terminal)The app auto-detects running Claude Code sessions via hooks and process scanning. To enable hook integration, configure your ~/.claude/settings.json to POST events to http://localhost:7890/hooks/<EventType>.
The garden renderer uses Phaser's Canvas backend plus resize-time scene rebuilds so minimize/restore stays stable in Electron. Initial garden generation, persisted bed layouts, and the activity log all restore on startup.
npx tsc --outDir test-build --skipLibCheck && node test-all.js # 334 tests- CURRENT-STAGE.md — Comprehensive project reference (architecture, file structure, implementation details)
- ARCHITECTURE.md — System diagrams and data flow
- PLAN.md — Phase implementation plan
MIT