--- title: "bd gitlab" description: "Commands for syncing issues between beads and GitLab." --- {/* AUTO-GENERATED: do not edit manually */} 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 [flags] ``` ## 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') ```