Grove

The terminal workspace manager for AI coding agents. Spin up a forest of isolated agent workspaces. Reach any of them asynchronously from your terminal, your browser, or another agent.

🌳 Overview

Grove runs several AI coding agents at once, each in its own isolated workspace: a dedicated git worktree on its own branch, paired with a tmux session and a window. The rule is one agent, one worktree, one window. Agents are productive in parallel but chaotic in the same folder, where they overwrite each other's files and collide on the same branch. Grove gives each one its own bench.

Every workspace is reachable asynchronously, from the terminal TUI, the CLI, the web IDE on any device, or another agent over MCP. The same isolated-workspace primitive backs human and agent orchestration alike. Through all of it your git history stays yours: Grove never commits, never pushes, and never touches a remote branch.

1-grove-terminal.mp4

✨ Features

A web IDE for your agents Reach the whole fleet over your network. A session rail lists every agent thread by recency; the landing is a composer, so a prompt spins up a workspace. Pair a device once and the daemon stays loopback. Space-black, dark-first. Docs →
Transcript, terminal, and diff in one shell Open a session and land in a three-zone shell: the rail, the agent's live transcript, and a tabbed work panel with terminal, diff, and info. Steer the agent with a follow-up while it works, answer its structured questions inline, and watch the diff grow. Docs →
Drive Grove from any agent Grove ships an MCP server. Claude Code, Codex, OpenCode, and other orchestrators use its tools to create workspaces, dispatch tasks, send follow-ups, and steer the fleet. Your agents manage work at the scale of a whole project. Docs →
Terminal UI Grove is a terminal program first. Run grove in a repo to see only its workspaces. Create, attach, pause, and kill, each one keypress. A peek rail mirrors the selected agent's pane live, next to its git position. Docs →

Also in the box:

• Branch-aware lifecycle. Create, pause, resume, respawn, and kill. Pause keeps the branch and drops the worktree. Kill deletes only branches Grove created, never remotes.
• Configuration cascade. A committed .grove/config.json sets the team baseline. Six layers let each developer override locally without touching it.
• Per-agent model selection. Each agent exposes its own model catalog. Pick the model per workspace: a cheap one for scaffolding, a strong one for the hard refactor, side by side.
• Session recovery. Grove pane-verifies each agent session and re-adopts it across daemon restarts and a different user attaching. A stale pointer remaps to the recovered session in a click.
• Ticket providers. Branch-aware Gitea, GitHub, and Linear context, surfaced next to the workspace.
• Push notifications. Get pinged when an agent finishes a turn or needs you.

2-grove-web.mp4

🚀 Get started

Grove needs git and tmux, and installs to your PATH as grove straight from the repo. With uv:

uv tool install "grove[daemon] @ git+https://github.com/bearlike/Grove"

cd path/to/your/repo
grove config init        # scaffold .grove/config.json
grove                    # launch the TUI
uv tool upgrade grove    # update later

No uv? Use pipx install "grove[daemon] @ git+https://github.com/bearlike/Grove" or plain pip install --user. See Get Started for prerequisites and every install path.

Important

Always install with the full @ git+... form above. The name grove on PyPI belongs to an unrelated package, so a bare uv tool install grove installs the wrong product.

🤖 Let an AI agent configure Grove for you

Configuration has a few layers and many knobs, so you do not have to write it by hand. Hand the prompt below to Claude Code, Codex, or any coding agent; it reads Grove's config skill and sets things up with you, verifying every field against your installed version.

Read https://raw.githubusercontent.com/bearlike/Grove/current/.claude/skills/configuring-grove/SKILL.md. It is the skill for configuring Grove, a terminal workspace manager for AI coding agents. Help me write my Grove user and project config, and verify every field against my installed version with `grove config schema --stdout`.

📚 Documentation

Full documentation lives at https://bearlike.github.io/Grove/latest/.

Section	Covers
Get Started	Install, prerequisites, first run, verify.
Configure	Project setup, agents, init scripts, configuration reference.
Use	TUI tour, CLI, web IDE, authentication, daily workflow.
Capabilities	Lifecycle, branch provenance, live activity, status semantics, configuration cascade.
Develop	Architecture, public API, engineering principles, contributing, design system.
Troubleshooting	Symptom → cause → fix for common failures.

🤝 Contributing

Bugs and feature requests on the issue tracker. For development setup, lint/test commands, and PR conventions, see the contributing guide and CLAUDE.md.

📄 License

MIT © Krishnakanth Alagiri.