GitHub
Sign in with GitHub to let agents push branches and open pull requests, and to browse a repo's issues. NeuralCode uses the official GitHub CLI under the hood.
How it works#
GitHub integration is built on the ghCLI. NeuralCode detects whether it's installed and authenticated, and lights up GitHub features accordingly. The sidebar account area and Settings → Account both surface this status.
Signing in#
Connecting GitHub uses the secure device-code flow — no passwords, no local server. NeuralCode shows you a short code; you paste it on github.com to authorize, and the app detects approval automatically and configures the CLI for you.
Connect GitHub
- 1Start the flowClick Connect GitHub in the sidebar or Settings → Account.
- 2AuthorizeCopy the displayed user code, click Open github.com/login/device, and paste it to approve.
- 3DoneNeuralCode polls for approval, fetches your profile, and signs the CLI in. Your token is stored locally and never shown back to the UI.
Installing the GitHub CLI#
If gh isn't installed, Settings → Git offers an Install button (via Homebrew). You can also install it yourself from cli.github.com.
| State | What's available |
|---|---|
| Not installed | GitHub features are off; install gh to enable them. |
| Installed, not signed in | Connect GitHub to authenticate the CLI. |
| Installed & authenticated | Pull requests and issues are fully enabled. |
Pull requests#
With GitHub ready, the Commit split-button's Commit, Push & PR action pushes the branch and opens a pull request with an auto-filled title and body; the PR URL appears in a toast.
store.json and is used solely to drive the gh CLI. Sign out any time from Settings → Account.