| 1 | # Beads Configuration File
|
|---|
| 2 | # This file configures default behavior for all bd commands in this repository
|
|---|
| 3 | # All settings can also be set via environment variables (BD_* prefix)
|
|---|
| 4 | # or overridden with command-line flags
|
|---|
| 5 |
|
|---|
| 6 | # Issue prefix for this repository (used by bd init)
|
|---|
| 7 | # If not set, bd init will auto-detect from directory name
|
|---|
| 8 | # Example: issue-prefix: "myproject" creates issues like "myproject-1", "myproject-2", etc.
|
|---|
| 9 | # issue-prefix: ""
|
|---|
| 10 |
|
|---|
| 11 | # Use no-db mode: JSONL-only, no Dolt database
|
|---|
| 12 | # When true, bd will use .beads/issues.jsonl as the source of truth
|
|---|
| 13 | # no-db: false
|
|---|
| 14 |
|
|---|
| 15 | # Enable JSON output by default
|
|---|
| 16 | # json: false
|
|---|
| 17 |
|
|---|
| 18 | # Feedback title formatting for mutating commands (create/update/close/dep/edit)
|
|---|
| 19 | # 0 = hide titles, N > 0 = truncate to N characters
|
|---|
| 20 | # output:
|
|---|
| 21 | # title-length: 255
|
|---|
| 22 |
|
|---|
| 23 | # Default actor for audit trails (overridden by BEADS_ACTOR or --actor)
|
|---|
| 24 | # actor: ""
|
|---|
| 25 |
|
|---|
| 26 | # Export events (audit trail) to .beads/events.jsonl on each flush/sync
|
|---|
| 27 | # When enabled, new events are appended incrementally using a high-water mark.
|
|---|
| 28 | # Use 'bd export --events' to trigger manually regardless of this setting.
|
|---|
| 29 | # events-export: false
|
|---|
| 30 |
|
|---|
| 31 | # Multi-repo configuration (experimental - bd-307)
|
|---|
| 32 | # Allows hydrating from multiple repositories and routing writes to the correct database
|
|---|
| 33 | # repos:
|
|---|
| 34 | # primary: "." # Primary repo (where this database lives)
|
|---|
| 35 | # additional: # Additional repos to hydrate from (read-only)
|
|---|
| 36 | # - ~/beads-planning # Personal planning repo
|
|---|
| 37 | # - ~/work-planning # Work planning repo
|
|---|
| 38 |
|
|---|
| 39 | # JSONL backup (periodic export for off-machine recovery)
|
|---|
| 40 | # Auto-enabled when a git remote exists. Override explicitly:
|
|---|
| 41 | # backup:
|
|---|
| 42 | # enabled: false # Disable auto-backup entirely
|
|---|
| 43 | # interval: 15m # Minimum time between auto-exports
|
|---|
| 44 | # git-push: false # Disable git push (export locally only)
|
|---|
| 45 | # git-repo: "" # Separate git repo for backups (default: project repo)
|
|---|
| 46 |
|
|---|
| 47 | # Integration settings (access with 'bd config get/set')
|
|---|
| 48 | # These are stored in the database, not in this file:
|
|---|
| 49 | # - jira.url
|
|---|
| 50 | # - jira.project
|
|---|
| 51 | # - linear.url
|
|---|
| 52 | # - linear.api-key
|
|---|
| 53 | # - github.org
|
|---|
| 54 | # - github.repo
|
|---|