Crate aether_project 

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

Re-exports

pub use aether_settings::AetherSettings;

pub use aether_settings::AetherSettingsSource;

pub use aether_settings::SettingsFileSource;

pub use aether_settings::project_settings_exist;

pub use aether_settings::project_settings_path;

pub use aether_settings::user_settings_exist;

pub use aether_settings::user_settings_path;

pub use prompt_file::PromptFile;

pub use prompt_file::PromptFileError;

pub use prompt_file::PromptTriggers;

pub use prompt_file::SKILL_FILENAME;

Modules

aether_settings

prompt_file

Structs

AgentCatalog

A resolved catalog of agents from a project.

AgentConfig

McpFileSpec

PromptCatalog

A catalog of prompt artifacts discovered from .aether/skills/.

Enums

McpSourceSpec

PromptSource

Authored description of a prompt source — text, a file path, or a glob pattern.

PromptSourceError

Errors raised while resolving PromptSource values into Prompts.

SettingsError

Errors that can occur during settings loading and agent resolution.