Pixir.Agents (pixir v0.1.0)

Copy Markdown View Source

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.

Summary

Functions

discover(workspace \\ File.cwd!(), opts \\ [])

List agents with deterministic precedence and duplicate warnings.

get(name, workspace \\ File.cwd!(), opts \\ [])

Resolve a single agent by name.

Functions

discover(workspace \\ File.cwd!(), opts \\ [])

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

List agents with deterministic precedence and duplicate warnings.

get(name, workspace \\ File.cwd!(), opts \\ [])

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

Resolve a single agent by name.