Skip to main content
subagent CX Codex

elixir-expert · voltagent/awesome-codex-subagents — Codex subagent for Elixir and OTP

elixir-expert — a subagent for Elixir and OTP work: processes, supervision, fault tolerance, Phoenix. Maps execution boundaries, identifies root causes, and proposes minimal safe changes.

MIT ★ 6,505 updated 2026-10-05

Install into Codex · Manually: put the files in place All methods and platforms ↓
.codex/agents/elixir-expert.toml
Open on GitHub

What elixir-expert does

elixir-expert handles process architecture, supervision trees, and message-passing contracts. It works with GenServer, Task, PubSub, analyzes mailbox pressure and delivery ordering. When you hit a fault-tolerance bug, timeouts amplifying cascades, or Phoenix controllers mishandling concurrent load, this subagent first draws the boundary (entry point, data path, external dependencies), finds the root, then offers the smallest fix that leaves the rest untouched.

It validates behavior through process boundaries (success and failure), checks queue-growth risks in hot paths, and keeps pattern matches and error tuples explicit. It flags cluster assumptions that need environment validation. It does not redesign process topology without explicit request.

What it helps with

  • uncover supervision chain leaks and restart-strategy mismatches
  • debug mailbox pressure and message ordering in GenServer
  • design fault tolerance without amplifying failure storms
  • verify message passing contracts and timeout semantics
  • integrate Phoenix controller or channel with safe concurrent handling

Example prompts for the agent

  • My GenServer hangs under peak load—what's queued and how do I prevent it?
  • A supervisor keeps restarting child processes in a loop. How do I find the real cause?
  • I need error handling in Phoenix LiveView but don't want to break client connections

How to install elixir-expert

Manually: put the files in place

.codex/agents/elixir-expert.toml

Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about elixir-expert

How do I install elixir-expert in Codex?

Create or edit .codex/agents/elixir-expert.toml at your project root. Codex loads the subagent automatically on next run.

What does elixir-expert do?

It analyzes Elixir and OTP work: processes, supervision, fault tolerance, Phoenix. It maps execution boundaries, finds root causes, recommends minimal safe changes, and validates that new code does not break the rest.

Why does explicit pattern matching and error tuples matter?

Hidden matches in processes lead to silent failures. Explicit patterns and errors form a contract between processes: when the contract breaks, you see it immediately, not through a production incident hours later.

Source text

elixir-expert.toml · MIT
# elixir-expert

Use when a task needs Elixir and OTP expertise for processes, supervision, fault tolerance, or Phoenix application behavior.

Own Elixir/OTP tasks as production behavior and contract work, not checklist execution.

Prioritize smallest safe changes that preserve established architecture, and make explicit where compatibility or environment assumptions still need verification.

Working mode:
1. Map the exact execution boundary (entry point, state/data path, and external dependencies).
2. Identify root cause or design gap in that boundary before proposing changes.
3. Implement or recommend the smallest coherent fix that preserves existing behavior outside scope.
4. Validate the changed path, one failure mode, and one integration boundary.

Focus on:
- process ownership and supervision-tree correctness
- message passing contracts, mailbox pressure, and ordering assumptions
- fault tolerance behavior and restart strategy suitability
- GenServer/Task/PubSub boundaries for changed flow
- back-pressure and timeout behavior in concurrent workloads
- Phoenix integration surfaces where controllers/channels are involved
- keeping immutable data transformations explicit and testable

Quality checks:
- verify success and failure behavior through supervising process boundaries
- confirm timeout/retry semantics do not amplify failure storms
- check mailbox or queue growth risks in hot paths
- ensure pattern matches and error tuples remain explicit and consistent
- call out cluster/distributed-runtime assumptions requiring environment validation

Return:
- exact module/path and execution boundary you analyzed or changed
- concrete issue observed (or likely risk) and why it happens
- smallest safe fix/recommendation and tradeoff rationale
- what you validated directly and what still needs environment-level validation
- residual risk, compatibility notes, and targeted follow-up actions

Do not introduce large process-topology or distribution redesign unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

Similar subagents

All subagents for Backend and APIs →

elixir-expert by other authors comes first.

elixir-expert VoltAgent Community elixir-expert reviews an Elixir project and helps implement changes using OTP, Phoenix, and Ecto. Use it when you need to reason about process architecture, fault handling, or tests. CX Codex 167installs elixir-expert 0xfurai elixir-expert — an Elixir-focused subagent for Claude: pattern matching, supervision trees, GenServers, Phoenix channels and ExUnit tests, with Dialyzer in the checklist. CX Codex ★ 1,029repo stars elixir Mindrally Tells your coding agent how to write Elixir and Phoenix: functional patterns, Ecto, LiveView, OTP. Useful when the project actually runs on BEAM. CX Codex +1 881installs elixir-pro Seth Hobson elixir-pro is a Claude Code subagent for Elixir development, from OTP architecture to Phoenix LiveView work. It joins refactoring and BEAM optimization tasks. CX Codex ★ 42,780repo stars elixir-code-review existential-birds elixir-code-review reviews Elixir files for OTP conventions, security caveats, and idiomatic style across .ex and .exs code. CX Codex +1 124installs elixir-otp-patterns TheBushidoCollective elixir-otp-patterns supplies AI coding assistants with standard Elixir OTP architectures for building concurrent and resilient services. CX Codex +1 106installs elixir-antipatterns tsardinasGitHub elixir-antipatterns is a Claude Code skill that guides code reviews, Ecto query tuning, and Phoenix refactoring with a catalog of 8 anti-patterns. CX Codex +1 194installs elixir-engineer-guidelines-cursorrules-prompt-file PatrickJS elixir-engineer-guidelines-cursorrules-prompt-file — a Cursor rule that frames work as senior Elixir engineering and sets a change-message format. Useful for Phoenix projects using the listed stack. CX Codex +1 ★ 41,178repo stars

From the same set176

The whole set →
flutter-expert flutter-expert — a Flutter-focused subagent for widget behavior, state, rendering, and cross-platform mobile work. Use it when a localized change needs architectural care. CX Codex ★ 6,505repo stars fastapi-developer fastapi-developer — a Codex subagent for FastAPI development — async operations, Pydantic v2 type-safe contracts, dependency injection, and ASGI deployment. Use when you need production API code with correct semantics. CX Codex ★ 6,505repo stars expo-react-native-expert expo-react-native-expert guides Expo and React Native mobile development, handling Expo Router navigation, native module configs, EAS builds, and UI performance. CX Codex ★ 6,505repo stars erlang-expert erlang-expert — a subagent for Erlang/OTP, rebar3, BEAM processes, and distributed logic. Maps execution boundaries, diagnoses architectural gaps, and proposes minimal safe changes. CX Codex ★ 6,505repo stars dotnet-framework-4.8-expert dotnet-framework-4.8-expert — a Codex subagent built for maintaining legacy .NET Framework 4.8 enterprise systems, config limits, and Windows-specific dependencies. CX Codex ★ 6,505repo stars dotnet-core-expert dotnet-core-expert examines .NET and ASP.NET Core work, including API behavior, middleware, hosting configuration, and cross-platform runtime effects. CX Codex ★ 6,505repo stars django-developer django-developer — a subagent for Django projects that understands models, views, forms, ORM and middleware. Takes on tasks tied to app architecture rather than checklist execution. CX Codex ★ 6,505repo stars csharp-developer csharp-developer is a Codex subagent for C# and .NET. It makes minimal fixes to APIs, service layers, and async flows while preserving contracts and architecture. CX Codex ★ 6,505repo stars

Project sponsors

Companies that keep this analytics open