Skip to main content
Generated from bd help --doc github. Commands for syncing issues between beads and GitHub. Configuration can be set via ‘bd config’ or environment variables: github.token / GITHUB_TOKEN - Personal access token github.owner / GITHUB_OWNER - Repository owner github.repo / GITHUB_REPO - Repository name github.repository / GITHUB_REPOSITORY - Combined “owner/repo” format github.url / GITHUB_API_URL - Custom API URL (GitHub Enterprise)

​
bd github pull

Pull one or more items from GitHub. Accepts bead IDs or external references as positional arguments. Equivalent to: bd github sync —pull-only —issues <refs>
Flags:

​
bd github push

Push one or more beads issues to GitHub. Accepts bead IDs as positional arguments. Equivalent to: bd github sync —push-only —issues <ids>
Flags:

​
bd github repos

List GitHub repositories that the configured token has access to.

​
bd github status

Display current GitHub configuration and sync status.

​
bd github sync

Synchronize issues between beads and GitHub. By default, performs bidirectional sync:
  • Pulls new/updated issues from GitHub to beads
  • Pushes local beads issues to GitHub
Use —pull-only or —push-only to limit direction.
Flags: