Repolode
oliver-kriska

oliver-kriska/claude-elixir-phoenix

A Claude Code plugin for Elixir/Phoenix with 26 specialist agents, Iron Laws enforcement, and Tidewave MCP integration for planning, implementing, and reviewing code.

Stars
573
Forks
45
Open issues
20
Last commit
yesterday

What is it?

Claude Code does not know Elixir and Phoenix pitfalls such as assign_new skipping on reconnect, floats corrupting money fields, or non-idempotent Oban jobs. This plugin adds domain knowledge and coordinates specialist agents that plan features with parallel research, execute tasks with compile checks after each change, and review code through parallel audits covering idioms, security, tests, and compilation.

The workflow follows a plan, work, verify, review, and compound lifecycle, with commands under the /phx:* namespace. Iron Laws are enforced by hooks that scan edits for issues like :float money fields, String.to_atom on user input, and unsupervised long-lived processes. Knowledge skills for LiveView, Ecto, Oban, security, and testing load automatically based on the files being edited.

The project also ships generated editions for Amp, Codex, Pi, OpenCode, and DeepSeek Harness, with varying levels of feature parity noted in its runtime support matrix.

Key features

  • 01Plans features with parallel research agents and writes structured plan files with checkboxes.
  • 02Runs compile checks after each change while executing plan tasks.
  • 03Enforces 26 Iron Laws through hooks that scan edits for common Elixir and Phoenix mistakes.
  • 04Runs four-agent parallel reviews covering idioms, security, tests, and compilation.
  • 05Auto-loads domain knowledge for LiveView, Ecto, Oban, and security based on edited files.
  • 06Integrates with Tidewave MCP.

Use cases

  • Building new Phoenix LiveView features with planned, verified steps.
  • Reviewing Elixir pull requests for security gaps and Ecto or Oban anti-patterns.
  • Investigating bugs in LiveView or Phoenix code with structured parallel tracks.
  • Onboarding a team to Phoenix conventions through enforced rules.

Quick start

  1. 1

    Add the marketplace in Claude Code

    /plugin marketplace add oliver-kriska/claude-elixir-phoenix
  2. 2

    Install the plugin

    /plugin install elixir-phoenix
  3. 3

    Plan a feature with the plugin's workflow command

    /phx:plan Add real-time comment notifications

Things to know

  • Requires Claude Code 2.1.110 or newer.
  • Opinionated for Elixir/Phoenix, so enabling it per project is recommended for multi-stack work.
  • Other runtimes such as Amp, Codex, Pi, OpenCode and DeepSeek Harness do not have full feature parity with the Claude Code plugin.
  • Upgrading from v2.x must follow a specific installation order or the plugin fails to load.

In collections

Topics

FAQ

What is claude-elixir-phoenix?
A Claude Code plugin for Elixir/Phoenix with 26 specialist agents, Iron Laws enforcement, and Tidewave MCP integration for planning, implementing, and reviewing code. Claude Code does not know Elixir and Phoenix pitfalls such as assign_new skipping on reconnect, floats corrupting money fields, or non-idempotent Oban jobs. This plugin adds domain knowledge and coordinates specialist agents that plan features with parallel research, execute tasks with compile checks after each change, and review code through parallel audits covering idioms, security, tests, and compilation.
Is claude-elixir-phoenix free to use? What license does it have?
claude-elixir-phoenix is open source under the MIT license. Check the license terms before using it in commercial products.
Is claude-elixir-phoenix still maintained?
Actively maintained. The last commit to claude-elixir-phoenix was on Nov 6, 2026.
What can I use claude-elixir-phoenix for?
Building new Phoenix LiveView features with planned, verified steps. Reviewing Elixir pull requests for security gaps and Ecto or Oban anti-patterns. Investigating bugs in LiveView or Phoenix code with structured parallel tracks. Onboarding a team to Phoenix conventions through enforced rules.
How do I install claude-elixir-phoenix?
Add the marketplace in Claude Code: /plugin marketplace add oliver-kriska/claude-elixir-phoenix Install the plugin: /plugin install elixir-phoenix Plan a feature with the plugin's workflow command: /phx:plan Add real-time comment notifications
Where can I get claude-elixir-phoenix?
The source code and installation instructions are on GitHub: https://github.com/oliver-kriska/claude-elixir-phoenix

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects