|
| 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 | +# Export events (audit trail) to .beads/events.jsonl on each flush/sync |
| 41 | +# When enabled, new events are appended incrementally using a high-water mark. |
| 42 | +# Use 'bd export --events' to trigger manually regardless of this setting. |
| 43 | +# events-export: false |
| 44 | + |
| 45 | +# Git branch for beads commits (bd sync will commit to this branch) |
| 46 | +# IMPORTANT: Set this for team projects so all clones use the same sync branch. |
| 47 | +# This setting persists across clones (unlike database config which is gitignored). |
| 48 | +# Can also use BEADS_SYNC_BRANCH env var for local override. |
| 49 | +# If not set, bd sync will require you to run 'bd config set sync.branch <branch>'. |
| 50 | +# sync-branch: "beads-sync" |
| 51 | + |
| 52 | +# Multi-repo configuration (experimental - bd-307) |
| 53 | +# Allows hydrating from multiple repositories and routing writes to the correct JSONL |
| 54 | +# repos: |
| 55 | +# primary: "." # Primary repo (where this database lives) |
| 56 | +# additional: # Additional repos to hydrate from (read-only) |
| 57 | +# - ~/beads-planning # Personal planning repo |
| 58 | +# - ~/work-planning # Work planning repo |
| 59 | + |
| 60 | +# Integration settings (access with 'bd config get/set') |
| 61 | +# These are stored in the database, not in this file: |
| 62 | +# - jira.url |
| 63 | +# - jira.project |
| 64 | +# - linear.url |
| 65 | +# - linear.api-key |
| 66 | +# - github.org |
| 67 | +# - github.repo |
0 commit comments