Back to Beads

bd notion

website/docs/cli-reference/notion.md

1.0.42.1 KB
Original Source
<!-- AUTO-GENERATED: do not edit manually -->

Generated from bd help --doc notion

bd notion

Commands for syncing issues between beads and Notion.

bd notion

bd notion connect

Connect bd to an existing Notion database or data source

bd notion connect [flags]

Flags:

      --url string   Existing Notion database or data source URL

bd notion init

Create a dedicated Beads database in Notion

bd notion init [flags]

Flags:

      --parent string   Parent page ID
      --title string    Database title (default "Beads Issues")

bd notion pull

Pull one or more items from Notion.

Accepts bead IDs or external references as positional arguments. Equivalent to: bd notion sync --pull --issues <refs>

bd notion pull [refs...] [flags]

Flags:

      --dry-run   Preview pull without making changes

bd notion push

Push one or more beads issues to Notion.

Accepts bead IDs as positional arguments. Equivalent to: bd notion sync --push --issues <ids>

bd notion push [bead-ids...] [flags]

Flags:

      --dry-run   Preview push without making changes

bd notion status

Show Notion sync status

bd notion status

bd notion sync

Synchronize issues between beads and Notion.

By default this performs bidirectional sync. Use --pull or --push to limit direction.

bd notion sync [flags]

Flags:

      --create-only     Only create missing remote pages, do not update existing ones
      --dry-run         Preview changes without making mutations
      --issues string   Comma-separated bead IDs to sync selectively (e.g., bd-abc,bd-def). Mutually exclusive with --parent.
      --parent string   Limit push to this bead and its descendants (push only). Mutually exclusive with --issues.
      --prefer-local    On conflict, keep the local beads version
      --prefer-notion   On conflict, use the Notion version
      --pull            Only pull issues from Notion
      --push            Only push issues to Notion
      --state string    Issue state to sync: open, closed, or all (default "all")