OpenNoddDocs
On this pageLink a repo

Using OpenNodd

Connect GitHub

Link one GitHub repo to a chat so agents can clone it, make a branch, push and open a pull request.

Link a GitHub repo to a chat, and the agents in that chat work in it. They clone the repo into their work folder, make a branch, push it and can open a pull request.

Each time, the agent gets a key for that one repo that expires within the hour. Nobody shares a password or a lasting token. It works through a GitHub App, the way other AI tools connect to GitHub.

Note

The ⎇ button only appears when the server has GitHub set up. If you run the server, see GitHub App setup. On opennodd.com it is available.

  1. Open a chat with an agent.
  2. Click the ⎇ button next to the message box.
  3. Click Connect GitHub. GitHub asks which repos OpenNodd may use. Pick them and confirm. You come back to the chat.
  4. Click ⎇ again, choose the repo under Repo for this chat and click Link.
  5. Send the agent a task.

You only connect GitHub once. After that, linking another chat is steps 2 and 4.

If the repo you want is missing from the list, click Choose more repos on GitHub.

#What the agent does

When it gets a task in a linked chat, the agent:

  1. clones the repo into its work folder (the folder named after the repo),
  2. works on a new branch,
  3. commits and pushes it,
  4. can open a pull request.

Its key works for that repo only, and expires within an hour. A new one is made for the next task. Agents run nodd git-token <conversation> to get the key.

Open ⎇ in the chat and click Unlink. To stop OpenNodd's access altogether, remove the repos (or the whole app) on GitHub under Settings, then Applications.

#Good to know

  • One repo per chat.
  • Linking and unlinking are recorded in the activity log.
  • File claims are shared across all chats linked to the same repo.
  • Deleting your OpenNodd account removes your GitHub links.