GitHub Integration

Seamlessly work with GitHub PRs and Issues directly from wt.

Setup

GitHub integration requires the GitHub CLI (gh). Install and authenticate:

bash

# Install gh (macOS)
brew install gh

# Authenticate
gh auth login

Run wt --setup to verify gh is properly configured. If gh is not authenticated, wt will offer to set it up for you.

Pull Requests

Access PRs via Ctrl+P or select "Review a PR" from the create menu.

+------------------------------------------------------------+
| Open PRs | Enter: select | Ctrl+O: open in browser         |
+------------------------------------------------------------+
| > #142  [ok] ~   feat: add dark mode            @john      |
|   #140  [fail]   fix: memory leak               @jane      |
|   #138  [..]     chore: update deps             @bob       |
|   #135  [--]     docs: update readme            @alice     |
|   #133  [draft]  wip: new feature               @dave      |
+------------------------------------------------------------+

CI Status Indicators

[ok]

All checks passed

CI is green, ready to merge

[fail]

Checks failed

CI has failing checks

[..]

Checks running

CI is still in progress

[--]

No checks

No CI configured for this PR

[draft]

Draft PR

PR is marked as draft, not ready for review

Review Status Indicators

Approved

PR has been approved by reviewers

Changes requested

Reviewers requested changes

PR Actions

After selecting a PR, choose an action:

Action	Description
Fix CI issues (auto)	Claude fetches failed CI logs, fixes the issues, and pushes. Only shown if CI failed.
Review this PR	Claude performs a comprehensive code review
Launch Claude	Start Claude with PR context to work on changes
Just create worktree	Checkout the PR branch without Claude

Issues

Access issues via Ctrl+G or select "From an issue" from the create menu.

+------------------------------------------------------------+
| Open Issues | Enter: select | Ctrl+O: open in browser      |
+------------------------------------------------------------+
| > #7   Add dark mode support                    @john      |
|   #5   Fix memory leak in parser                @jane      |
|   #3   Update documentation                     @bob       |
+------------------------------------------------------------+

Issue Actions

After selecting an issue, choose an action:

Action	Description
Auto-resolve (full auto)	Claude reads the issue, implements the solution, and creates a PR automatically
Launch Claude	Start Claude with issue context in your preferred mode
Just create worktree	Create the branch without Claude assistance

Branch Naming

When creating a worktree from an issue, wt automatically creates a branch named:

bash

feature/{issue-number}-{issue-title-slug}

# Example: Issue #7 "Add dark mode support"
feature/7-add-dark-mode-support

Browser Integration

Press Ctrl+O to open in browser

When viewing PRs or issues, press Ctrl+O to open the selected item in your default browser. This works without leaving the wt interface.

Tips

Preview pane: When browsing PRs or issues, a preview pane shows details like description, labels, and stats.

Existing worktrees: If a worktree already exists for a PR branch, wt will navigate to it instead of creating a new one.

gh auth: If you're not authenticated with gh, wt will offer to set it up when you try to access PR or issue features.