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

Pixir — an OTP-native, terminal-first coding agent.

Pixir is a local-first runtime built around a small spine:
`Pixir.Session` -> `Pixir.Turn` -> `Pixir.Provider` -> `Pixir.Tools`.
The append-only `Pixir.Log` is the source of truth, and front-ends observe
canonical and ephemeral facts through `Pixir.Events`.

The public architecture is intentionally split across focused modules:

- `Pixir.Conversation` is the UI-agnostic multi-turn driver.
- `Pixir.ACP` modules present the same runtime over ACP/JSON-RPC stdio.
- `Pixir.Skills` loads progressive-disclosure instruction packages.
- `Pixir.Subagents` supervises delegated child Sessions.
- `Pixir.Workflows` runs deterministic dependency graphs over Subagents.
- `Pixir.Delegate` scaffolds the Codex/GPT-first delegate CLI contract.
- `Pixir.SessionTree` projects read-only Session/Subagent trees from Logs.
- `Pixir.Compaction` records durable History checkpoints for bounded replay.

See `CONTEXT.md` for vocabulary and `docs/adr/` for accepted architecture
decisions.

# `version`

```elixir
@spec version() :: String.t()
```

Pixir version (from `mix.exs`).

---

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