# Graphite for Raycast

URL: https://www.raycast.com/michalzuch/graphite

> Review, approve, comment on, and merge the pull requests in your Graphite inbox. Requires the Graphite and GitHub CLIs.

- Install: raycast://extensions/michalzuch/graphite
- Author: [michał zuch](https://www.raycast.com/michalzuch)
- Installs: 0
- Platforms: macOS
- Categories: Developer Tools, Productivity, AI Extensions
- Updated: 2026-11-17
- Source: https://github.com/raycast/extensions/tree/ac35588052d79e801b57da94970dfb60a1a0e29b/extensions/graphite/

## Commands

- **Pull Request Inbox**: See the pull requests in your Graphite inbox, then read, approve, comment on, and merge them.

## AI tools

- **Get Inbox**: List the pull requests in your Graphite PR inbox by section, with review status, unresolved comments, CI checks, and merge status.
- **Get Pull Request**: Read a pull request in full: description, reviews, unresolved comments, checks, and Graphite's merge status.
- **Review Pull Request**: Approve, request changes on, or comment on a pull request with the GitHub CLI, after you confirm.
- **Merge Pull Request**: Merge a pull request and the pull requests below it in its stack with Graphite, after you confirm. Only merges when Graphite says it's ready.

## README

### Graphite

Your [Graphite](https://graphite.com) pull request inbox in Raycast. Read pull requests, approve, comment, and merge stacks, or ask Raycast AI what needs your attention.

#### Setup

1. Install the [Graphite CLI](https://graphite.com/docs/install-the-cli) with `brew install withgraphite/tap/graphite`, then sign in with `gt auth --token <token>` using a token from [app.graphite.com/activate](https://app.graphite.com/activate).
2. Install the [GitHub CLI](https://cli.github.com) with `brew install gh`, then sign in with `gh auth login`. You need it for reviews, comments, checks, and merging.

If Raycast can't find `gt` or `gh`, set its path in the extension preferences.

#### Pull Request Inbox

Shows your Graphite inbox sections, such as "Needs your review" and "Returned to you", with review status, unresolved comments, CI checks, and merge readiness for each pull request.

- **Configure Sections** (`⌘⇧S`) hides or reorders sections. Create new ones in Graphite.
- **Show Pull Request** (`↵`) opens the description, unresolved comments, and reviews. `⌘I` toggles a side panel.
- **Approve** (`⌘⇧A`), **Request Changes** (`⌘⇧X`), and **Comment** (`⌘⇧K`) post reviews to GitHub.
- **Merge with Graphite** (`⌘⇧↵`) works like Graphite's Merge button: it merges the stack up to the selected pull request, through the merge queue if your repository uses one.
- **Check out Locally** (`⌘⇧G`) runs `gt get` in your local clone. Set **Repository Folders** if your code isn't in a common folder like `~/code`.

Press `⌘K` for all actions and shortcuts.

#### Inbox Menu Bar

Shows your inbox and the number of pull requests waiting on you. Turn it on in Raycast Settings → Extensions → Graphite.

#### Raycast AI

Mention `@graphite` in AI Chat or Quick AI:

- "@graphite what needs my review?"
- "@graphite summarize the unresolved comments on my billing PR"
- "@graphite approve acme/web#482"
- "@graphite merge acme/web#482"

Raycast asks you to confirm before anything is posted or merged. Requires [Raycast Pro](https://www.raycast.com/pro).

#### Privacy

Graphite has no public API. Like Graphite's own menu bar app, the extension uses the token saved by `gt auth` and sends it only to Graphite. These endpoints aren't documented, so they could change. GitHub requests go through your own `gh` login; the extension never stores a GitHub token.
