vtcode-config 0.98.6

Config loader components shared across VT Code and downstream adopters
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63

# vtcode-config

Config loader components shared across VT Code and downstream adopters.

Exposes `VTCodeConfig` and `ConfigManager` for reading and validating
`vtcode.toml` files. Applications can customize the filesystem layout via
`ConfigDefaultsProvider` and opt into the `bootstrap` feature (enabled by
default) to scaffold configuration directories with project-specific defaults.

## Modules

| Module | Purpose |
|---|---|
| `loader` | Config parsing, merging, watching, and layer stack |
| `core` | Primary config structs (`AgentConfig`, `ModelConfig`, `SandboxConfig`, …) |
| `defaults` | `ConfigDefaultsProvider` and helpers for search paths |
| `acp` | Agent Client Protocol configuration |
| `api_keys` | API key source resolution |
| `auth` | OAuth / ChatGPT / Copilot auth flows |
| `codex` | TUI and history persistence settings |
| `constants` | Compile-time constants |
| `context` | Dynamic context and ledger settings |
| `debug` | Debug and trace configuration |
| `hooks` | Lifecycle hook configuration |
| `ide_context` | IDE context provider configuration |
| `mcp` | MCP server and client configuration |
| `models` | Model identifiers and metadata |
| `optimization` | Performance tuning knobs (caching, pooling, profiling) |
| `subagents` | Sub-agent discovery and specs |

## Public entrypoints

| Export | Description |
|---|---|
| `VTCodeConfig` | Deserialized configuration root |
| `ConfigManager` | Load, merge, and watch configuration files |
| `ConfigDefaultsProvider` | Trait for customizing default paths and values |
| `install_config_defaults_provider` | Register a custom defaults provider globally |
| `ConfigLayerStack` | Ordered stack of config layers with merge semantics |
| `ConfigWatcher` / `SimpleConfigWatcher` | File-system watchers for live reload |

## Usage

```rust
use vtcode_config::ConfigManager;

fn main() -> anyhow::Result<()> {
    let manager = ConfigManager::load_from_workspace(".")?;
    println!("Active provider: {}", manager.config().agent.provider);
    Ok(())
}
```

## Features

| Feature | Default | Description |
|---|---|---|
| `bootstrap` | ✓ | Scaffold config directories on first load |
| `schema` | — | JSON Schema generation via `schemars` |

## API reference

<https://docs.rs/vtcode-config>