Should .beads/metadata.json or config.yaml be added to git?

[sandover]

It would be nice to make the documentation explicit on this.

[steveyegge]

Yes, both should be committed to git.

These files contain repository-specific configuration that should be shared across all developers and agents working on the project:

.beads/metadata.json

• Basic project metadata (database and JSONL export filenames)
• Repository-specific, not machine-specific

.beads/config.yaml

• Repository settings like issue-prefix (e.g., "bd" for this project)
• Default behavior for bd commands in this repo
• Team-wide configuration preferences

Neither file is excluded by .gitignore. The .gitignore only excludes runtime/temporary files:

• daemon.log, daemon.pid, daemon.lock, bd.sock
• db.sqlite, bd.db (JSONL is the source of truth for git)
• Temporary merge snapshot files

Committing these files ensures everyone on the team has consistent beads behavior and project setup.