Struct AetherSettings 

pub struct AetherSettings {
    pub agent: Option<String>,
    pub prompts: Vec<PromptSource>,
    pub mcps: Vec<McpSourceSpec>,
    pub providers: ProviderConnectionOverrides,
    pub credentials_store: Option<CredentialsStoreConfig>,
    pub telemetry: Option<TelemetrySettings>,
    pub agents: Vec<AgentConfig>,
}

The root of an Aether settings file (.aether/settings.json). It selects the default agent and defines the agents, prompt sources, MCP servers, and provider overrides available to a project.

Basic Examples

A minimal project with a single user-invocable agent:

{
  "agent": "Build",
  "agents": [
    {
      "name": "Build",
      "description": "Builds features and fixes bugs",
      "model": "anthropic:claude-sonnet-4-5-20250929",
      "userInvocable": true
    }
  ]
}

A fuller setup with shared prompts, an MCP source, and a provider override:

{
  "agent": "Build",
  "prompts": ["AGENTS.md"],
  "mcps": [".aether/mcp.json"],
  "providers": {
    "anthropic": { "auth": "default" }
  },
  "agents": [
    {
      "name": "Build",
      "description": "Builds features and fixes bugs",
      "model": "anthropic:claude-sonnet-4-5-20250929",
      "reasoningEffort": "high",
      "userInvocable": true,
      "prompts": [".aether/BUILD.md", "AGENTS.md"]
    }
  ]
}

An encrypted file credential store using a passphrase from the environment:

{
  "credentialsStore": {
    "type": "encryptedFile",
    "passwordEnv": "PASSWORD_ENV_VAR_NAME"
  },
  "agents": [
    {
      "name": "Build",
      "description": "Builds features and fixes bugs",
      "model": "anthropic:claude-sonnet-4-5-20250929",
      "userInvocable": true
    }
  ]
}

OpenTelemetry

OpenTelemetry is enabled by adding a telemetry section to settings. User-level telemetry settings merge with project-level, with project-level taking priority. Prompt, response, reasoning, and tool content is not exported unless the matching telemetry.content flag is explicitly set to true.

{
  "telemetry": {
    "serviceName": "aether",
    "sampleRatio": 1.0,
    "content": {
      "systemInstructions": false,
      "inputMessages": false,
      "outputMessages": false,
      "toolDefinitions": false,
      "toolCalls": false
    },
    "traces": { "enabled": true },
    "metrics": { "enabled": true },
    "otlp": {
      "endpoint": "http://localhost:4318"
    }
  },
  "agents": [
    {
      "name": "Build",
      "description": "Builds features and fixes bugs",
      "model": "anthropic:claude-sonnet-4-5-20250929",
      "userInvocable": true
    }
  ]
}

All content flags default to false; enable only the content attributes appropriate for your collector and its access controls. See the website telemetry reference for the complete attribute mapping.

For an OTLP backend with exact signal URLs, set otlp.tracesEndpoint and otlp.metricsEndpoint. Aether sends each configured signal to its matching URL unchanged; an unconfigured signal uses the /v1/traces or /v1/metrics URL derived from otlp.endpoint.

Fields

agent: Option<String>

Name of the agent to launch by default. Must match a name in agents. When unset, Aether falls back to the first user-invocable agent.

prompts: Vec<PromptSource>

Default prompt sources shared by all agents. An agent inherits these only when its own prompts array is empty.

mcps: Vec<McpSourceSpec>

Default MCP sources shared by all agents. An agent inherits these only when its own mcps array is empty.

providers: ProviderConnectionOverrides

Provider connection overrides (credentials, base URLs, inference profiles) applied to every agent unless overridden per-agent.

credentials_store: Option<CredentialsStoreConfig>

Credential storage backend for OAuth tokens. Defaults to the OS keyring when unset.

telemetry: Option<TelemetrySettings>

OpenTelemetry GenAI telemetry configuration. Its presence enables telemetry.

agents: Vec<AgentConfig>

The agents defined for this project. At least one agent is required.

Implementations

impl AetherSettings

pub fn load_default(project_root: &Path) -> Result<Self, SettingsError>

pub fn load( project_root: &Path, sources: impl IntoIterator<Item = AetherSettingsSource>, ) -> Result<Self, SettingsError>

pub fn load_file_for_export(path: &Path) -> Result<Self, SettingsError>

pub fn merge(self, next: Self) -> Self

pub fn inline_resources(&mut self, root: &Path) -> Result<(), SettingsError>

Replace every file- and glob-backed prompt and MCP source with its inlined contents, resolving paths against root.

The result serializes to a self-contained settings document with no external file references, suitable for shipping to a machine or container that does not have the authoring repository mounted.

Trait Implementations

impl Clone for AetherSettings

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AetherSettings

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for AetherSettings

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for AetherSettings

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for AetherSettings

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl PartialEq for AetherSettings

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for AetherSettings

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for AetherSettings

impl TryFrom<&str> for AetherSettings

type Error = SettingsError

The type returned in the event of a conversion error.

fn try_from(content: &str) -> Result<Self, Self::Error>

Performs the conversion.