User guide
Connect GitHub CLI
Use the GitHub account already signed in on your Mac to work with repositories, issues, and pull requests through your Familiar.
Connecting GitHub CLI lets your Familiar use the gh tools already installed on your Mac — inspecting issues and pull requests, calling the GitHub API, and working with local repositories within whatever access you grant.
Install and connect
- Install the official GitHub CLI on the Mac running OpenCircle Desktop, or keep the one you already have.
- Open Connections → Computer use → GitHub CLI and choose Refresh.
- If it already says signed in, confirm it's the account you want. Otherwise choose Sign in to GitHub.
- GitHub opens in your browser with a one-time code — enter it on GitHub's device sign-in page.
- Finish authorization, return to OpenCircle, and confirm the card says Signed in.
OpenCircle uses your Mac's normal gh configuration, so switching accounts here also changes anything else on that machine using the same CLI login. Sign-in here selects HTTPS for Git; it doesn't set up SSH keys.
Try it with your Familiar
In a private conversation, name a repository you can access:
Use GitHub CLI on my Mac to list the open pull requests in example-org/sample-app. Summarize their titles and review status. Don't change anything.
Fix a connection
| What you see | What to do |
|---|---|
| gh not installed | Install GitHub CLI on this Mac, then Refresh — installing it on the Server won't fix this. |
| Signed out | Choose Sign in to GitHub and finish the browser flow. |
| Wrong account | Switch accounts in your Mac's terminal or sign in to the right one there, then Refresh. |
| Signed in, repo inaccessible | Check the repository name and your account's organization permissions. |
Never paste access tokens, passwords, or sign-in codes into a conversation with your Familiar. Need remote shell access too? See SSH access.