aether-project 0.4.3

Project-local settings and agent discovery for the Aether AI agent framework
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

# 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

<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->

- [Key Types](#key-types)
- [Usage](#usage)
- [License](#license)

<!-- END doctoc generated TOC please keep comment here to allow auto update -->

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

```rust,no_run
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