Terminals

Real PTY sessions bound to a worktree, in an adaptive grid.

Every worktree gets one or more terminal panes, arranged in an adaptive grid. Terminals are real PTY sessions — top, htop, vim, and full-screen TUIs all work. On Windows the default shell is PowerShell; you can change the shell, font, and scrollback length in settings.

Working directory#

Each terminal opens in its worktree's folder, so commands run against the right checkout from the start.

An agent started in a GridTree terminal automatically inherits its context — which worktree it's in, and how to reach this GridTree instance. So once you've set up the MCP server for that agent, it can act on this worktree from here without any per-terminal configuration.

Session restore#

When you reopen GridTree, it restores your layout: the same projects, worktrees, tabs, and terminal panes come back. The shells themselves are started fresh — a terminal's running process and scrollback don't survive quitting the app.

Shortcuts#

These are the defaults. You can rebind any of them under Settings → Keyboard shortcuts.