# GitHub for Raycast

URL: https://www.raycast.com/raycast/github

> Work with issues, pull requests, manage workflows, search repositories and stay on top of notifications

- Install: raycast://extensions/raycast/github
- Author: [Raycast](https://www.raycast.com/raycast)
- Installs: 219,758
- Platforms: macOS, Windows
- Categories: Developer Tools, Productivity, AI Extensions
- Updated: 2026-11-12
- Source: https://github.com/raycast/extensions/tree/0721a4296480afc863f16e6caed4109cc3ef305c/extensions/github/

## Commands

- **My Pull Requests**: List pull requests you created, participated in, or were mentioned in.
- **Search Pull Requests**: Search recent pull requests globally in all repositories.
- **Create Pull Request**: Create a pull request in one of your GitHub repositories.
- **My Issues**: List issues created by you, assigned to you or mentioning you.
- **Search Issues**: Search recent issues globally in all repositories.
- **Create Issue**: Create an issue in one of your GitHub repositories.
- **Create Release**: Create a release in one of your GitHub repositories.
- **Search Repositories**: Search in your public or private repositories by name.
- **My Latest Repositories**: List your repositories by latest updated
- **My Starred Repositories**: List repositories you have starred
- **My Packages**: List packages you published to GitHub Packages
- **Workflow Runs**: Manage workflow runs for a selected GitHub repository.
- **Dispatch Workflow**: Trigger a workflow_dispatch workflow in one of your GitHub repositories.
- **Notifications**: List inbox notifications from all repositories or a selected repository.
- **Unread Notifications**: Shows unread notifications in the macOS menu bar.
- **My Projects**: Show your Projects
- **My Issues Menu Bar**: Display My Issues in the Menu Bar
- **My GitHub Stats Menu Bar**: Display your GitHub profile stats (followers, stars received, PRs, issues, commits) in the Menu Bar
- **My Pull Requests Menu Bar**: Display My Pull Requests in the Menu Bar
- **My Packages Menu Bar**: Display My Packages in the Menu Bar
- **Download Repository as ZIP**: Download a repository or directory as a ZIP archive (does not create a Git clone)

## AI tools

- **Issues**: Search issues to mention in AI Chat, listing open issues you're involved in by default.
- **Pull Requests**: Search pull requests to mention in AI Chat, listing open pull requests you're involved in by default.
- **Repositories**: Search repositories to mention in AI Chat, listing your most recently pushed repositories by default.
- **Get Notifications**: Get the list of notifications of current user
- **Search Issues**: Search github issues
- **Search Pull Requests**: Search github pull requests
- **Search Repositories**: Search github repositories
- **Enable Auto-Merge**: Enable auto-merge on a pull request
- **Disable Auto-Merge**: Disable auto-merge on a pull request
- **Merge Pull Request**: Merge Pull Request
- **Close Pull Request**: Close Pull Request
- **Reopen Pull Request**: Reopen Pull Request
- **Close Issue**: Close the issue with provided reason
- **Reopen Issue**: Reopen Issue
- **List Workflow Runs**: List Workflow Runs
- **Re-Run Workflow**: Re-run Workflow
- **Cancel Workflow**: Cancel Workflow
- **Run Workflow**: Run Workflow
- **Get Pull Request Diff**: Get the files changed in a pull request along with their patches
- **Create Repository**: Create a repository on the user's account or in one of their organizations

## README

### GitHub

Work with issues, pull requests, manage workflows, search repositories and stay on top of notifications.

#### Mentions in AI Chat

Type `@` in the AI Chat composer and pick **GitHub** to mention an issue, pull request, or repository. Without a query, **Issues** and **Pull Requests** list open items you're involved in and **Repositories** lists your most recently pushed repositories. Paste `owner/repo#123` or a GitHub URL to jump to an exact issue or pull request. The mention gives AI the item's current details, including the description of issues and pull requests.

#### Configuring a Personal Access Token

You can use a personal access token instead of logging in through OAuth to authenticate your GitHub account:

The following link can be used as a shortcut to create your token:
<https://github.com/settings/tokens/new?description=Raycast&scopes=repo,read:org,read:user,project,notifications,read:packages>

Otherwise, you can manually create it:

1. Go to <https://github.com/settings/tokens>
2. Click "Generate new token" then "Generate new token (classic)
3. Add a "Note" for the token.
4. Select the required scopes:

- `repo`
- `read:org`
- `read:user`
- `project`
- `notifications`
- `read:packages` (only needed for the _My Packages_ commands)

5. Click "Generate token".
6. Copy the token in the "GitHub Token" field in the extension's preferences.

#### Cloning and Downloading Repositories

The extension provides two different ways to get repository files locally:

- **Clone and Open (Default Path)** runs `git clone` and opens the repository in your configured IDE. It uses:
  `<Default Clone Path>/<repository-name>`.
- **Clone with Options (Choose Path)** also runs `git clone`, but lets you choose or override the destination for that clone.
- **Download as ZIP** downloads an archive of a repository or directory. It does not create a Git repository and does not use the Default Clone Path.

To clone a repository:

1. Set **Default Clone Path** and **IDE Application** in the extension preferences if you want to use **Clone and Open (Default Path)**.
2. Open **Search Repositories** and select a repository.
3. Open the Action Panel (`⌘K`) and choose **Clone and Open (Default Path)** or **Clone with Options (Choose Path)**.

The **Default Clone Path** preference applies only to these extension clone actions. It is not used by **Download as ZIP** or by a natural-language request to the GitHub AI assistant; those flows may use their own destination or working directory.

#### Menu Bar Commands

This extension ships four independent Menu Bar Commands. They can be enabled together or in any combination depending on what you want at a glance from your menu bar.

- **My GitHub Stats Menu Bar** — A profile-centric overview: followers, stars received, organizations, API rate limit, plus a small _Activity_ drill-down with the **5 most recently updated** PRs and issues you authored or have open. Optionally surfaces a _What's New_ section when one of your repositories receives new stars. Designed for users who want a single icon in the menu bar that summarises everything about _you_.
- **My Pull Requests Menu Bar** — An inbox-style command focused on Pull Requests: configurable sections for assigned / mentioned / reviewed / review-requested / drafts, repository filtering, sortable list, and CI status icons (draft, merge-queue, success, failure, pending). Use this if you want a dedicated PR triage surface.
- **My Issues Menu Bar** — The Issue counterpart of _My Pull Requests Menu Bar_: dedicated sections for created / assigned / mentioned / recently closed, repository filtering, sortable. Use this if you want a dedicated Issue triage surface.
- **My Packages Menu Bar** — Your published packages grouped by registry (Container, npm, Maven, Docker, NuGet, RubyGems), with a configurable number of packages per registry. The title can show either the package count or one package's name and download count.

The activity drill-down in _My GitHub Stats Menu Bar_ is intentionally a thin convenience — it shows just the 5 most recently updated items per category, with no filters or sorting, so users who keep only that single command enabled still have one-click access to their latest work. For a richer, more configurable PR or Issue workflow, enable the dedicated _My Pull Requests Menu Bar_ or _My Issues Menu Bar_ alongside it.

#### Commands Disabled by Default

For simplicity, some commands are disabled by default. To use them, you can enable them in the extension's settings. These include:

- `Create Branch`
- `My Discussions`
- `Search Discussions`

#### FAQ

##### Can I use my GitHub pull request or issue template?

Yes! Templates for pull requests and issues are supported as long as they are in the `.github` directory.

##### Why can't I see my GitHub organization?

Double-check that you have enabled the correct settings for your organizations on the [GitHub Oauth page](https://github.com/settings/connections/applications/7235fe8d42157f1f38c0) to ensure that Raycast is able to show you the data from those repositories.
