* docs: generate CLI reference from live help * docs(cli): move bd version stamp from per-command pages to index only Drops the `(bd version X.Y.Z)` suffix from the auto-generated header on every per-command CLI reference page (writeSingleCommandDoc) and the docs/CLI_REFERENCE.md preamble (writeAllHelp). The version label now lives only on the index page emitted by scripts/generate-cli-docs.sh: - Dev tree (website/docs/cli-reference/index.md, docs/CLI_REFERENCE.md): labelled "Latest" - Versioned snapshots (website/versioned_docs/version-X.Y.Z/...): labelled with the explicit semver tag parsed from the directory name This eliminates the 100+-file no-signal diff a release version bump otherwise produces, restoring the "regen as a separate small commit" workflow PR #3704 enables. After this change a version bump alone yields zero diff on the dev tree; only the new versioned snapshot created at release-cut time carries the new tag. No datestamps are introduced anywhere — scripts/generate-cli-docs.sh --check remains deterministic across CI runs. Refs: mybd-afb, PR #3704 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> --------- Co-authored-by: CI Bot <ci@beads.test> Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2.2 KiB
2.2 KiB
| id | title | slug | sidebar_position |
|---|---|---|---|
| notion | bd notion | /cli-reference/notion | 999 |
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")