Module config 

Modules

schema

Auto-generated config schema from Config struct metadata.

setter

Generic config setter that works for ALL schema-known keys.

Structs

AliasEntry

A user-defined command alias mapping for shell compression patterns.

ArchiveConfig

Settings for the zero-loss compression archive (large tool outputs saved to disk).

AutonomyConfig

Controls autonomous background behaviors (preload, dedup, consolidation).

CloudConfig

Cloud sync and contribution settings (pattern sharing, model pulls).

Config

Global lean-ctx configuration loaded from config.toml, merged with project-local overrides.

EmbeddingConfig

Semantic-embedding engine settings.

GainConfig

Settings for publishing your token-savings recap (gain --publish / auto-publish).

LoopDetectionConfig

Thresholds for detecting and throttling repetitive agent tool call loops.

McpBridgeEntry

MemoryGuardConfig

RSS-based memory guardian configuration.

ProviderEntryConfig

Per-provider configuration entry.

ProvidersConfig

Configuration for external context providers (GitHub, GitLab, Jira, etc.). Each provider can be enabled/disabled and configured with auth tokens. Override individual tokens via env vars (GITHUB_TOKEN, GITLAB_TOKEN, etc.).

ProxyConfig

API proxy upstream overrides. None = use provider default.

SecretDetectionConfig

SetupConfig

Controls what lean-ctx injects during setup and update --rewire. Fresh installs default to non-invasive (rules/skills off, MCP on). Users who ran setup interactively get explicit true/false. None = undecided (legacy: check if rules already exist and preserve behavior).

UpdatesConfig

Controls automatic update behavior. All defaults are OFF — auto-updates require explicit opt-in via lean-ctx setup or lean-ctx update --schedule.

Enums

CompressionLevel

Each level maps to specific component settings via to_components().

MemoryCleanup

Controls how aggressively lean-ctx frees memory when idle.

MemoryProfile

Controls RAM usage vs. feature richness trade-off.

OutputDensity

Legacy: Controls how dense/compact MCP tool output is formatted. Superseded by CompressionLevel. Kept for backward compatibility with old config.toml files. New setups use compression_level instead. See CompressionLevel::effective().

PermissionInheritance

Whether lean-ctx mirrors the host IDE’s tool-permission rules onto its own MCP tools (“permission inheritance”).

ProxyProvider

ResponseVerbosity

Unified compression level that replaces the 4 separate legacy concepts: terse_agent, output_density, terse_mode, and crp_mode.

RulesInjection

How agent rules are injected for AGENTS.md/CLAUDE.md/GEMINI.md consumers.

RulesScope

Where agent rule files are installed: global home dir, project-local, or both.

SavingsFooter

Controls visibility of token savings footers in tool output.

ShellActivation

Controls when the shell hook auto-activates command aliases.

TeeMode

Controls when shell output is tee’d to disk for later retrieval.

TerseAgent

Legacy: Controls agent output verbosity level injected into MCP instructions. Superseded by CompressionLevel. Kept for backward compatibility with old config.toml files. New setups use compression_level instead. See CompressionLevel::effective().

Constants

DEFAULT_BM25_PERSIST_MB

Effective on-disk ceiling (MB) for the persisted BM25 index when nothing is explicitly configured (no bm25_max_cache_mb, no max_disk_mb budget).

Functions

default_bm25_max_cache_mb

Default BM25 cache cap from config (also used by bm25_index heuristics).

is_local_proxy_url

last_config_parse_error

Returns the most recent global config parse error, or None if the current config.toml parsed successfully (or no config file exists).

normalize_url

normalize_url_opt