aether-project

Project-local and user-level settings plus agent catalog resolution for the Aether AI agent framework. Reads user settings from $AETHER_HOME/settings.json or $HOME/.aether/settings.json, then project settings from .aether/settings.json, to discover agents, prompts, and MCP server configurations.

Table of Contents

• Key Types
• Usage
• License

Key Types

• AetherSettings -- Parsed project settings from .aether/settings.json
• AgentCatalog -- Resolved catalog of project agents with their prompts, models, and tool filters
• PromptCatalog -- Collection of project prompt files
• SettingsError -- Settings validation errors

Usage

.aether/settings.json supports top-level prompts and mcps as typed defaults. An agent without local prompts inherits top-level prompts; an agent without local mcps inherits top-level mcps. Agent-local prompts or mcps replace the corresponding top-level defaults for that agent.

AetherSettings::load_default loads user settings first, then project settings. User settings come from $AETHER_HOME/settings.json when AETHER_HOME is set, otherwise $HOME/.aether/settings.json or %USERPROFILE%/.aether/settings.json. Project settings come from project_root/.aether/settings.json. Missing default files are ignored. Relative prompt and MCP paths in user settings resolve against $AETHER_HOME; relative prompt and MCP paths in project settings resolve against project_root. When multiple sources define an agent with the same name, the later source wins, so project agents override user agents with the same name.

use aether_project::{AetherSettings, AgentCatalog};
use std::path::Path;

let project_root = Path::new(".");
let settings = AetherSettings::load_default(project_root).unwrap();
let catalog = if settings.agents.is_empty() {
    AgentCatalog::empty(project_root.to_path_buf())
} else {
    AgentCatalog::from_settings(project_root, settings).unwrap()
};

println!("Project root: {:?}", catalog.project_root());

for agent in catalog.all() {
    println!("Agent: {} (model: {})", agent.name, agent.model);
}

License

MIT