Struct Config 

pub struct Config {
    pub output: Option<String>,
    pub filter: Option<Vec<String>>,
    pub ignore: Option<Vec<String>>,
    pub line_numbers: Option<bool>,
    pub preview: Option<bool>,
    pub token_count: Option<bool>,
    pub output_folder: Option<String>,
    pub timestamped_output: Option<bool>,
    pub yes: Option<bool>,
    pub auto_diff: Option<bool>,
    pub diff_context_lines: Option<usize>,
    pub diff_only: Option<bool>,
}

Global configuration loaded from .context-builder.toml.

Any field left as None means “use the CLI default / do not override”. Command-line arguments always take precedence over values provided here.

Example .context-builder.toml:

output = "context.md"
output_folder = "docs"
timestamped_output = true
auto_diff = true
diff_only = true         # Emit only change summary + modified file diffs (no full file bodies)
filter = ["rs", "toml"]
ignore = ["target", ".git"]
line_numbers = false
diff_context_lines = 5

Fields

output: Option<String>

Output file name (or base name when timestamped_output = true)

filter: Option<Vec<String>>

File extensions to include (no leading dot, e.g. rs, toml)

ignore: Option<Vec<String>>

File / directory names to ignore (exact name matches)

line_numbers: Option<bool>

Add line numbers to code blocks

preview: Option<bool>

Preview only the file tree (no file output)

token_count: Option<bool>

Token counting mode

output_folder: Option<String>

Optional folder to place the generated output file(s) in

timestamped_output: Option<bool>

If true, append a UTC timestamp to the output file name (before extension)

yes: Option<bool>

Assume “yes” for overwrite / processing confirmations

auto_diff: Option<bool>

Enable automatic diff generation (requires timestamped_output = true)

diff_context_lines: Option<usize>

Override number of unified diff context lines (falls back to env or default = 3)

diff_only: Option<bool>

When true, emit ONLY:

• Header + file tree
• Change Summary
• Per-file diffs for modified files

Excludes full file contents section entirely. Added files appear only in the change summary (and are marked Added) but their full content is omitted.

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() -> Config

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.