Connecting a Repository

Linking a board to GitHub takes two steps: add a personal access token once, then connect (or create) a repository for the board.

1. Add a GitHub token

The app needs a GitHub personal access token with the repo scope.

1. Open Settings → GitHub Keys and paste the token into GitHub Token, then Save. (You can also paste it directly the first time you open the GitHub dialog.)
2. No token yet? Click Create a token → in the dialog — it opens GitHub’s new-token page pre-filled with the repo scope, which lets the app read, create, and push to your repositories.

The token is stored locally — in the OS keyring on the desktop app, in your browser otherwise — and is shared across all boards. You only add it once.

2. Open the GitHub dialog

Click the GitHub icon in the top toolbar.

The icon reflects the board’s connection state:

• Greyed — not connected. The tooltip reads *Connect to GitHub*.
• Highlighted — connected. The tooltip shows *GitHub: owner/repo*.
• Pulsing green dot — a newer release is available to import. The tooltip reads *New GitHub release available*.

3. Connect or create a repo

The dialog offers two paths.

Connect existing repo

Paste owner/repo (or a full GitHub URL — the app strips https://github.com/ and a trailing .git) into the field and click Connect. The repository must already exist and your token must have access to it.

Create new repo

Type a name (for example my-board-repo), choose whether it is Private (on by default), and click Create & connect. The app creates a fresh, initialized repository on your account and connects this board to it in one step.

Once connected, the dialog shows the repository name with shortcuts to Open on GitHub, Refresh the status, and Disconnect.

Disconnecting

Click Disconnect in the connected view. This only removes the link between the board and the repo on this machine — it never deletes the repository or its releases on GitHub. You can reconnect the same repo at any time.

Connecting the same repo elsewhere

To work on a board across computers, connect the same repository on each machine. Save a release on one, then import it on the other — see Saving and Importing Versions.

Where to go next

• Saving and Importing Versions — commit versions and roll back.
• Agent-Built Boards — hand the repo to an external agent.
• Configuring API Keys — where the GitHub token lives in Settings.