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: load from JSONL, no SQLite, write back after each command
12  # When true, bd will use .beads/issues.jsonl as the source of truth
13  # instead of SQLite database
14  # no-db: false
15  
16  # Disable daemon for RPC communication (forces direct database access)
17  # no-daemon: false
18  
19  # Disable auto-flush of database to JSONL after mutations
20  # no-auto-flush: false
21  
22  # Disable auto-import from JSONL when it's newer than database
23  # no-auto-import: false
24  
25  # Enable JSON output by default
26  # json: false
27  
28  # Default actor for audit trails (overridden by BD_ACTOR or --actor)
29  # actor: ""
30  
31  # Path to database (overridden by BEADS_DB or --db)
32  # db: ""
33  
34  # Auto-start daemon if not running (can also use BEADS_AUTO_START_DAEMON)
35  # auto-start-daemon: true
36  
37  # Debounce interval for auto-flush (can also use BEADS_FLUSH_DEBOUNCE)
38  # flush-debounce: "5s"
39  
40  # Git branch for beads commits (bd sync will commit to this branch)
41  # IMPORTANT: Set this for team projects so all clones use the same sync branch.
42  # This setting persists across clones (unlike database config which is gitignored).
43  # Can also use BEADS_SYNC_BRANCH env var for local override.
44  # If not set, bd sync will require you to run 'bd config set sync.branch <branch>'.
45  # sync-branch: "beads-sync"
46  
47  # Multi-repo configuration (experimental - bd-307)
48  # Allows hydrating from multiple repositories and routing writes to the correct JSONL
49  # repos:
50  #   primary: "."  # Primary repo (where this database lives)
51  #   additional:   # Additional repos to hydrate from (read-only)
52  #     - ~/beads-planning  # Personal planning repo
53  #     - ~/work-planning   # Work planning repo
54  
55  # Integration settings (access with 'bd config get/set')
56  # These are stored in the database, not in this file:
57  # - jira.url
58  # - jira.project
59  # - linear.url
60  # - linear.api-key
61  # - github.org
62  # - github.repo