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 [command]

​
bd gitlab projects

List GitLab projects that the configured token has access to. 
bd gitlab projects [flags]

​
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> 
bd gitlab pull [refs...] [flags]
Flags: 
      --dry-run   Preview pull without making changes

​
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> 
bd gitlab push [bead-ids...] [flags]
Flags: 
      --dry-run   Preview push without making changes

​
bd gitlab status

Display current GitLab configuration and sync status. 
bd gitlab status [flags]

​
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. 
bd gitlab sync [flags]
Flags: 
      --assignee string       Filter by assignee username
      --dry-run               Show what would be synced without making changes
      --exclude-type string   Exclude these issue types from sync (comma-separated)
      --issues string         Comma-separated bead IDs to sync selectively (e.g., bd-abc,bd-def). Mutually exclusive with --parent.
      --label string          Filter by labels (comma-separated, AND logic)
      --milestone string      Filter by milestone title
      --no-ephemeral          Exclude ephemeral/wisp issues from push (default: true) (default true)
      --parent string         Limit push to this bead and its descendants (push only). Mutually exclusive with --issues.
      --prefer-gitlab         On conflict, use GitLab version
      --prefer-local          On conflict, keep local beads version
      --prefer-newer          On conflict, use most recent version (default)
      --project string        Filter to issues from this project ID (group mode)
      --pull-only             Only pull issues from GitLab
      --push-only             Only push issues to GitLab
      --type string           Only sync these issue types (comma-separated, e.g. 'epic,feature,task')