Struct Config 

pub struct Config {

    pub project_root: Option<PathBuf>,
    pub validation_depth: u32,
    pub checkpoint_ttl_hours: u32,
    pub max_symbol_depth: u32,
    pub formatter_timeout_secs: u32,
    pub type_checker_timeout_secs: u32,
    pub format_on_edit: bool,
    pub hashline_enabled: bool,
    pub validate_on_edit: Option<String>,
    pub formatter: HashMap<String, String>,
    pub checker: HashMap<String, String>,
    pub restrict_to_project_root: bool,
    pub search_index: bool,
    pub index: IndexConfig,
    pub semantic_search: bool,
    pub views: ViewsConfig,
    pub aft_search_registered: bool,
    pub callgraph_store: bool,
    pub callgraph_chunk_size: usize,
    pub experimental_bash_rewrite: bool,
    pub experimental_bash_compress: bool,
    pub experimental_bash_background: bool,
    pub max_background_bash_tasks: usize,
    pub bash_long_running_reminder_enabled: bool,
    pub bash_long_running_reminder_interval_ms: u64,
    pub foreground_wait_window_ms: u64,
    pub bash: BashConfig,
    pub bash_permissions: bool,
    pub sandbox: SandboxConfig,
    pub search_index_max_file_size: u64,
    pub semantic: SemanticBackendConfig,
    pub inspect: InspectConfig,
    pub backup: BackupConfig,
    pub worktree: WorktreeConfig,
    pub github: GithubConfig,
    pub gh_shim: GhShimConfig,
    pub gh_read: GhReadConfig,
    pub git: GitConfig,
    pub experimental_lsp_ty: bool,
    pub lsp_servers: Vec<UserServerDef>,
    pub disabled_lsp: HashSet<String>,
    pub diagnostics_on_edit: bool,
    pub lsp_paths_extra: Vec<PathBuf>,
    pub lsp_auto_install_binaries: HashSet<String>,
    pub lsp_inflight_installs: HashSet<String>,
    pub storage_dir: Option<PathBuf>,
    pub url_fetch_allow_private: bool,
    pub hoist_builtin_tools: bool,
    pub tool_surface: String,
    pub disabled_tools: Vec<String>,
    pub harness: Option<Harness>,
    pub diagnostic_cache_size: usize,
    pub idle: IdleConfig,
}

Fields

project_root: Option<PathBuf>

Root directory of the project being analyzed. None if not scoped.

validation_depth: u32

How many levels of call-graph edges to follow during validation (default: 1).

checkpoint_ttl_hours: u32

Hours before legacy backup-session maintenance may collect inactive history (default: 24). Named checkpoint retention is intentionally fixed at fourteen days and is not controlled by configuration.

max_symbol_depth: u32

Maximum depth for recursive symbol resolution (default: 10).

formatter_timeout_secs: u32

Seconds before killing a formatter subprocess (default: 10).

type_checker_timeout_secs: u32

Seconds before killing a type-checker subprocess (default: 30).

format_on_edit: bool

Whether to auto-format files after edits (default: false).

hashline_enabled: bool

Whether the hashline edit/read surface is enabled for eligible sessions. Resolved from the public edit_mode enum in aft.jsonc.

validate_on_edit: Option<String>

Whether to auto-validate files after edits (default: false). When “syntax”, only tree-sitter parse check. When “full”, runs type checker.

formatter: HashMap<String, String>

Per-language formatter overrides. Keys: “typescript”, “python”, “rust”, “go”. Values: “biome”, “oxfmt”, “prettier”, “deno”, “ruff”, “black”, “rustfmt”, “goimports”, “gofmt”, “none”.

checker: HashMap<String, String>

Per-language type checker overrides. Keys: “typescript”, “python”, “rust”, “go”. Values: “tsc”, “tsgo”, “biome”, “pyright”, “ruff”, “cargo”, “go”, “staticcheck”, “none”.

restrict_to_project_root: bool

Whether to restrict file operations to within project_root (default: false). When true, write-capable commands reject paths outside the project root.

search_index: bool

Enable the trigram search index (default: false).

index: IndexConfig

User-tier standing roots. Empty by default, so normal session indexing is unchanged.

semantic_search: bool

Enable semantic search (default: false).

views: ViewsConfig

Content-addressed index view assembly. Disabled by default.

aft_search_registered: bool

Whether the plugin registered the aft_search tool for this surface (default: false). Forwarded by the plugin’s resolved registration predicate (semantic on + not minimal + not disabled). Used only to pick the grep-rewrite footer: when true the footer steers to aft_search, otherwise to the grep tool. Not a capability gate.

callgraph_store: bool

Enable the persisted callgraph store substrate (default: true).

callgraph_chunk_size: usize

Number of files to parse in a single batch during callgraph store cold build (default: 100). Lower values reduce peak memory during cold build. Set to 0 to disable chunking and parse all files at once.

experimental_bash_rewrite: bool

Enable experimental bash command rewriting (default: false).

experimental_bash_compress: bool

Enable experimental bash command compression (default: false).

experimental_bash_background: bool

Enable experimental bash background execution (default: false).

max_background_bash_tasks: usize

Maximum number of background bash tasks allowed to run concurrently (default: 8).

bash_long_running_reminder_enabled: bool

Emit reminders for long-running bash tasks (default: true).

bash_long_running_reminder_interval_ms: u64

Milliseconds between long-running bash reminders (default: 10 minutes).

foreground_wait_window_ms: u64

Milliseconds to wait before a foreground bash task is promoted to background handling.

bash: BashConfig

Plugin-owned bash settings accepted by configure but inert in the engine.

bash_permissions: bool

Enable OpenCode-style bash permission prompts (default: false).

sandbox: SandboxConfig

Native sandbox policy for first-party bash and PTY processes.

search_index_max_file_size: u64

Maximum file size to fully index in bytes (default: 1MB).

semantic: SemanticBackendConfig

inspect: InspectConfig

backup: BackupConfig

worktree: WorktreeConfig

Linked-worktree RAM overlay. Default off; see WorktreeConfig.

github: GithubConfig

Resolved GitHub integration gates. User configuration only.

gh_shim: GhShimConfig

Effective gh shim gate plus its legacy binary override.

gh_read: GhReadConfig

Effective structured GitHub read gate retained for the read engine API.

git: GitConfig

Git attribution for AFT-spawned agent children. Default off.

experimental_lsp_ty: bool

Enable Astral ty as an experimental Python LSP server (default: false).

lsp_servers: Vec<UserServerDef>

User-defined LSP servers registered by the OpenCode plugin.

disabled_lsp: HashSet<String>

Lowercase LSP server IDs disabled by user config.

diagnostics_on_edit: bool

Whether the system should request inline diagnostics after a tool call edits or writes a file.

lsp_paths_extra: Vec<PathBuf>

Extra directories to search when resolving LSP binaries. The plugin populates these from its own auto-install cache (e.g. ~/.cache/aft/lsp-packages/<pkg>/node_modules/.bin/) so an LSP binary installed by AFT is discoverable without needing it on PATH. Resolution order: <project_root>/node_modules/.bin/<bin> → lsp_paths_extra/<bin> (in order) → PATH via which. Python-family servers additionally probe the selected workspace’s .venv/venv first.

lsp_auto_install_binaries: HashSet<String>

Binary names the hosting plugin knows how to auto-install.

Built-in LSPs discovered from files only emit missing-binary warnings when their binary is in this set. User-configured lsp_servers keep warning unconditionally.

lsp_inflight_installs: HashSet<String>

Binary names with plugin-managed auto-installs currently in flight.

Missing-binary warnings are suppressed while the install is actively running; install failure reporting is handled by the plugin after the background work settles.

storage_dir: Option<PathBuf>

Persistent storage directory for indexes (trigram, semantic). Set by the plugin to the XDG-compliant path (e.g. ~/.local/share/opencode/storage/plugin/aft/). Falls back to ~/.cache/aft/ if not set.

url_fetch_allow_private: bool

Allow URL-fetch commands to access private network hosts. Default false; hosting plugins only forward this from user-level config.

hoist_builtin_tools: bool

Resolved host-tool registration preference. The Rust core retains this value for cross-harness config parity; the hosting plugin owns registration.

tool_surface: String

Resolved tool-surface tier (“minimal”, “recommended”, or “all”). The hosting plugin owns registration; the core keeps the value so it can reach the same conclusion about which built-in slots survive.

disabled_tools: Vec<String>

Agent-visible tool names the user switched off. Kept for the same reason as tool_surface: slot-survival questions must be answered identically on both sides of the plugin boundary.

harness: Option<Harness>

Hosting harness identity supplied by configure.

diagnostic_cache_size: usize

Maximum number of (server, file) entries kept in the in-memory diagnostic cache. Older entries are evicted in LRU order when the cap is exceeded. Set to 0 to disable the cap entirely. Default: 5000 (covers very large monorepos with bounded memory).

idle: IdleConfig

Idle reclamation windows for unbound-root artifacts and language servers.

Implementations

impl Config

pub fn semantic_backend_label(&self) -> &'static str

impl Config

pub fn read_slot_survives(&self) -> bool

Whether the host’s tagged read slot survives surface, hoisting, and disable filters.

Only a tagged read mints the [path#TAG] snapshots a hashline patch can address, so a session that lost the read slot must not be offered the hashline edit arm. The predicate is deliberately spelled the same way as the plugins’ registration check so both sides of the boundary classify a given config identically.

Trait Implementations

impl Clone for Config

fn clone(&self) -> Config

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

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

where Config: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

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.