Struct Config 

pub struct Config {
    pub registry: RegistryConfig,
    pub workspace: WorkspaceConfig,
    pub sync: Option<SyncConfig>,
    pub terminal: Option<TerminalConfig>,
    pub editor: Option<EditorConfig>,
    pub defaults: DefaultsConfig,
    pub groups: BTreeMap<String, Vec<String>>,
    pub repos: BTreeMap<String, RepoConfig>,
    pub specs: Option<SpecsConfig>,
    pub agents: AgentsConfig,
    pub update: UpdateConfig,
}

Top-level LOOM configuration, stored at ~/.config/loom/config.toml

Fields

registry: RegistryConfig

workspace: WorkspaceConfig

sync: Option<SyncConfig>

terminal: Option<TerminalConfig>

editor: Option<EditorConfig>

defaults: DefaultsConfig

groups: BTreeMap<String, Vec<String>>

Named repo groups for quick workspace creation. Each group maps a name to a list of repo names (bare or org/name).

repos: BTreeMap<String, RepoConfig>

Per-repo settings (e.g., workflow). Keyed by repo name.

specs: Option<SpecsConfig>

Specs conventions for generated CLAUDE.md.

agents: AgentsConfig

update: UpdateConfig

Auto-update settings.

Implementations

impl Config

pub fn load() -> Result<Self>

Load config from ~/.config/loom/config.toml

pub fn load_from(path: &Path) -> Result<Self>

Load config from a specific path (useful for testing)

pub fn save(&self) -> Result<()>

Save config to ~/.config/loom/config.toml atomically

pub fn save_to(&self, path: &Path) -> Result<()>

Save config to a specific path atomically (useful for testing)

pub fn default_config() -> Self

Sensible defaults for loom init

pub fn path() -> Result<PathBuf>

Path to the config file: ~/.config/loom/config.toml

Hardcoded to ~/.config/loom/ for cross-platform consistency. This matches developer tool conventions (ripgrep, bat, starship) and avoids the directories crate’s macOS path (~Library/Application Support/).

pub fn validate_agent_config(&self) -> Result<()>

Validate only the agent config section (no path-existence checks).

Use this during loom init where paths may not exist yet. Validate agent permission and sandbox syntax only.

This checks allowed_tools format, sandbox paths, and preset entries without requiring that scan_roots or workspace.root exist on disk. Safe to call at init time before directories are created. Does not check marketplace/plugin entries — use validate() for the full post-load check.

pub fn validate(&self) -> Result<()>

Full post-load validation: path existence, branch prefix, marketplace/plugin entries, and all agent config (delegates to validate_agent_config()).

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<'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 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.