Open an existing Project on your Mac.

Before you start#

You need macOS 14 (Sonoma) or later and a GitHub.com account. Desktop browsing supports personal and organization Projects. GitHub Enterprise Server is not supported.

Download the ZIP from the download page, unzip it, and move GitStride.app into Applications.

Connect your GitHub account#

1. Open GitStride. In the welcome window, choose Open GitHub Settings, then Log In to GitHub….
2. Choose Copy Code and Open GitHub. Paste the code into GitHub’s device activation page and approve access.
3. Select your personal account or organization, then open a Project you already use.

You can reopen connection settings under Settings → GitHub → Account. The welcome window can be reopened from Help → Welcome to GitStride….

Know what you authorize#

Desktop OAuth requests repo project read:org offline_access. The repo scope includes reading and writing repository code, including private repositories. It is broader than board-only access. Access and refresh tokens are stored in macOS Keychain.

Your GitHub permissions determine what you can view and edit. Organization policies or SSO may require additional authorization. Read privacy and permissions for local cache details.

Already using GitHub CLI?#

The GitHub Release build can reuse a CLI login. Install GitHub CLI, then run:

gh auth login --hostname github.com
gh auth refresh --hostname github.com --scopes project,read:org

Disconnect the current app connection, then choose Settings → GitHub → Connection method → GitHub CLI. GitStride uses the account selected at connection time until you reconnect. Disconnecting GitStride does not log your terminal out of GitHub.

Continue with your existing workflow#

Use the workspace guide to explore views and editing. PR automation is optional and has a separate authorization flow; it is not required to browse or edit Projects.