GitHub

Bring issues and pull requests into the sidebar, and branch from them.

The GitHub integration surfaces your repository's issues and pull requests inside GridTree, so you can create a worktree from an issue and track PR status without leaving the app.

Connect#

Open Settings → GitHub. You can authenticate two ways:

• GitHub CLI — if gh is installed and already signed in, GridTree uses that authentication directly. Nothing to paste.
• Personal access token — GridTree links you to GitHub's token page (with the repo scope pre-selected). Create the token, paste it back, and GridTree validates and stores it encrypted on your machine.

Repository detection#

GridTree detects the repository automatically from the project's origin remote (or any github.com remote). You don't list repos in a config file — if the clone points at GitHub, it's picked up. You can re-detect from settings if you change the remote.

What you get#

• Issues and pull requests in the sidebar, grouped by saved filter sections you define per project.
• Browse and read — open the issues from your filters and read their full descriptions without leaving GridTree.
• Start work from an issue or PR — create a worktree for it (the branch is named from the issue following the project's branch-name pattern) and hand it straight to an agent with a quick action. The agent can pull the issue's details over the MCP server to start with the full context.
• PR status on worktrees — see at a glance which worktree's branch has an open PR and where it stands.