# `Pixir.Agents`
[🔗](https://github.com/Ranvier-Technologies/pixir/blob/main/lib/pixir/agents.ex#L1)

Built-in and custom Subagent role discovery (ADR 0011).

Agent configs are lightweight TOML-like files. Pixir parses the subset needed for
role selection: `name`, `description`, `developer_instructions`, and optional
`model`, `model_reasoning_effort`, and `sandbox_mode`.

# `discover`

```elixir
@spec discover(
  String.t(),
  keyword()
) :: {:ok, %{agents: [map()], warnings: [map()]}}
```

List agents with deterministic precedence and duplicate warnings.

# `get`

```elixir
@spec get(String.t(), String.t(), keyword()) :: {:ok, map()} | {:error, map()}
```

Resolve a single agent by name.

---

*Consult [api-reference.md](api-reference.md) for complete listing*