Connect GitHub

GitHub is optional: a thread can start in an empty project and link a repository later. Connecting it lets agents clone, push and open pull requests as you, and lets you review and merge from Statefold.

Connect your account and install the App

1. Sign in with GitHub, or choose Connect GitHub in Settings → Account.
2. In Settings → GitHub, choose Install GitHub App and pick the repositories Statefold may access. Manage repository access changes that list later.

Agents use your GitHub App user token for git and gh. Like every credential, it stays on the Worker side: the workspace gets a placeholder that is replaced only on requests to GitHub. Pushes and pull requests always use your GitHub account.

Commit identity

Settings → GitHub sets how commits are attributed:

• Commit author: you with Statefold as co-author, Statefold with you as co-author, or Statefold.
• Commit email: your private GitHub address by default.
• Branch prefix for the branches agents create, and Open as drafts for new pull requests.

A commit hook in every workspace enforces the identity you choose.

Link a repository to a running thread

In thread details, Link repository links GitHub to the thread without replacing its files or history. An agent can do the same with its link_current_task_repository tool.

Ship and pull requests

Ship opens the Ship changes dialog and asks the agent to follow the project's shipping behavior: Push a branch and open a PR (the default), Ship to base branch, or Custom instructions. A linked pull request shows its number and check state in the thread header and the sidebar.

Pull requests in the sidebar lists open pull requests across your repositories. A pull request page can merge (squash, merge commit or rebase), close, reopen and delete the branch, comment as your GitHub account, and ask the agent to Fix checks, Address reviews or Resolve conflicts.

To start work from GitHub itself, see GitHub mentions.