Skip to content

docs: update for v0.10.0 #4

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
schovi merged 1 commit into from
Jun 10, 2026
Merged

docs: update for v0.10.0 #4

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,14 @@ Release notes for Git Treehouse.

Dates use the GitHub release publication date for published releases. Entries without a GitHub release use the annotated tag date.

## v0.10.0 - 2026-06-10

### New Features

#### Checkout PR Into A Worktree

Added a palette-only `Checkout PR` command. Open the command palette (`Ctrl+P`) and run `Checkout PR` to open a centered picker that loads up to 200 pull requests via `gh pr list --state all`, sorted by most recently updated (open, draft, merged, and closed). Type to filter by PR number, title, URL, owner, head branch, or local branch name; `↑`/`↓` (or `k`/`j`) move the selection. `Enter` checks out the highlighted PR into a worktree: it cd's into an existing non-prunable worktree, runs `git worktree add` for an existing local branch, or fetches `pull/<number>/head` and creates a new worktree branch for a new PR. Same-repo PRs use `headRefName`; fork PRs use `<owner>/<headRefName>`. On success the app cd's into the worktree and exits. `o` opens the highlighted PR in the browser; if the input is a PR URL or number not in the list, `Enter`/`o` act on it directly. `Esc` closes the picker, and there is no global keybinding for this flow.

## v0.9.0 - 2026-06-10

### New Features
Expand Down
12 changes: 12 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -198,6 +198,16 @@ Path: /Users/me/work/.worktrees/api/feature-login

To change where new worktrees go, press `ctrl+o` in the create popup. This opens `~/.config/git-treehouse/config.toml`. Save the file and `git-treehouse` reloads it while the popup is still open.

### Checkout A Pull Request

1. Press `Ctrl+P` to open the command palette.
2. Run `Checkout PR`.
3. Type to filter the list (PR number, title, URL, owner, or branch).
4. Move with `up` / `down` (or `k` / `j`).
5. Press `Enter` to check the PR out into a worktree, or `o` to open it in the browser.

The picker loads up to 200 pull requests via `gh` (open, draft, merged, and closed). `Enter` reuses an existing worktree or branch when present, otherwise it fetches the PR head and creates a new worktree. On success your shell moves into the worktree. This flow is available from the palette only; there is no dedicated key.

### Delete A Worktree

1. Focus a worktree row.
Expand Down Expand Up @@ -400,6 +410,8 @@ If `gh` is installed and authenticated, `git-treehouse` loads PR data in the bac

If `gh` is missing or unauthenticated, PR columns stay hidden or pending without noisy errors.

The `Checkout PR` palette command also uses `gh` to list pull requests and check one out into a worktree. See [Checkout A Pull Request](#checkout-a-pull-request).

## Troubleshooting

### Pressing Enter Only Prints A Path
Expand Down
Loading