Quick start
From a fresh install to a worktree with a running agent, in three steps.
From a fresh install to a worktree with a running agent, in three steps.
1. Add a project#
Open GridTree, choose Add project, and browse to a local git clone. The project appears in the tab strip, and GridTree reads its branches, status, and — if you've connected them — its GitHub and Jira issues.
2. Create a worktree#
Open the new-worktree dialog from the worktree list. Pick an existing branch, or create a new branch and choose the base branch to fork from. GridTree:
- adds a git worktree in its own folder (by default
<repo>.worktrees/<branch>next to your clone), - runs any post-creation commands you've configured (for example
npm install), - and opens a terminal pane in the new directory.
3. Launch an agent#
Open a terminal in the worktree (one is already there after creation) and start your coding agent — for example:
$ claude
An agent started in a GridTree terminal automatically knows which worktree it's in. If you've set up the MCP server, it can call back into GridTree to list worktrees, read issues, and start your app — scoped to exactly this worktree.
To start the app itself rather than an agent, define a build & run config and launch it with Ctrl+Shift+R.