Skip to main content
Generated from bd help --doc gitlab. Commands for syncing issues between beads and GitLab. Configuration can be set via ‘bd config’ or environment variables: gitlab.url / GITLAB_URL - GitLab instance URL gitlab.token / GITLAB_TOKEN - Personal access token gitlab.project_id / GITLAB_PROJECT_ID - Project ID or path gitlab.group_id / GITLAB_GROUP_ID - Group ID for group-level sync gitlab.default_project_id / GITLAB_DEFAULT_PROJECT_ID - Project for creating issues in group mode

bd gitlab projects

List GitLab projects that the configured token has access to.

bd gitlab pull

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

bd gitlab push

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

bd gitlab status

Display current GitLab configuration and sync status.

bd gitlab sync

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