Struct Config 

pub struct Config {

    pub project: String,
    pub next_id: u32,
    pub auto_close_parent: bool,
    pub max_tokens: u32,
    pub run: Option<String>,
    pub plan: Option<String>,
    pub max_loops: u32,
    pub max_concurrent: u32,
    pub poll_interval: u32,
    pub extends: Vec<String>,
    pub rules_file: Option<String>,
    pub file_locking: bool,
    pub on_close: Option<String>,
    pub on_fail: Option<String>,
    pub post_plan: Option<String>,
    pub verify_timeout: Option<u64>,
    pub review: Option<ReviewConfig>,
}

Fields

project: String

next_id: u32

auto_close_parent: bool

Auto-close parent beans when all children are closed/archived (default: true)

max_tokens: u32

Maximum tokens for bean context (default: 30000)

run: Option<String>

Shell command template for --run. Use {id} as placeholder for bean ID. Example: claude -p "implement bean {id} and run bn close {id}". If unset, --run will print an error asking the user to configure it.

plan: Option<String>

Shell command template for planning large beans. Uses {id} placeholder. If unset, plan operations will print an error asking the user to configure it.

max_loops: u32

Maximum agent loops before stopping (default: 10, 0 = unlimited)

max_concurrent: u32

Maximum parallel agents for bn run (default: 4)

poll_interval: u32

Seconds between polls in –watch mode (default: 30)

extends: Vec<String>

Paths to parent config files to inherit from (lowest to highest priority). Supports ~/ for home directory. Paths are relative to the project root.

rules_file: Option<String>

Path to project rules file, relative to .beans/ directory (default: “RULES.md”). Contents are injected into every bn context output.

file_locking: bool

Enable file locking for concurrent agents (default: false). When enabled, agents lock files listed in bean paths on spawn and lock-on-write during execution. Prevents concurrent agents from clobbering the same file.

on_close: Option<String>

Shell command template to run after a bean is successfully closed. Supports template variables: {id}, {title}, {status}, {branch}. Runs asynchronously — failures are logged but don’t affect the close.

on_fail: Option<String>

Shell command template to run after a verify attempt fails. Supports template variables: {id}, {title}, {attempt}, {output}, {branch}. Runs asynchronously — failures are logged but don’t affect the operation.

post_plan: Option<String>

Shell command template to run after bn plan creates children. Supports template variables: {id}, {parent}, {children}, {branch}. Runs asynchronously — failures are logged but don’t affect the plan.

verify_timeout: Option<u64>

Default timeout in seconds for verify commands (default: None = no limit). Per-bean verify_timeout overrides this value.

review: Option<ReviewConfig>

Adversarial review configuration (bn review / bn run --review). Optional — review is disabled if not configured.

Implementations

impl Config

pub fn load(beans_dir: &Path) -> Result<Self>

Load config from .beans/config.yaml inside the given beans directory.

pub fn load_with_extends(beans_dir: &Path) -> Result<Self>

Load config with inheritance from extended configs.

Resolves the extends field, loading parent configs and merging inheritable fields. Local values take precedence over extended values. Fields project, next_id, and extends are never inherited.

pub fn save(&self, beans_dir: &Path) -> Result<()>

Save config to .beans/config.yaml inside the given beans directory.

pub fn rules_path(&self, beans_dir: &Path) -> PathBuf

Return the path to the project rules file. Defaults to .beans/RULES.md if rules_file is not set. The path is resolved relative to the beans directory.

pub fn increment_id(&mut self) -> u32

Return the current next_id and increment it for the next call.

Trait Implementations

impl Debug for Config

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Config

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Config

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Config

fn eq(&self, other: &Config) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Config

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Config