Elixir Phoenix Codex Plugin

A Codex-oriented port of Oliver Kriska's claude-elixir-phoenix plugin for Elixir, Phoenix, LiveView, Ecto, Oban, OTP, and Tidewave-assisted development.

This repository packages the upstream workflow and domain knowledge as Codex skills. The original Claude Code slash-command style has been translated to Codex skill names such as phx-plan, phx-work, phx-review, and phx-verify.

Attribution

This project is based on oliver-kriska/claude-elixir-phoenix by Oliver Kriska.

The upstream project is licensed under MIT:

• Copyright (c) 2025-2026 Oliver Kriska
• Original repository: https://github.com/oliver-kriska/claude-elixir-phoenix

Codex-specific changes in this port include manifest conversion, skill naming conversion, Codex install documentation, AGENTS.md initialization guidance, and removal of Claude-specific hook files.

What Is Included

• skills/ contains the Elixir/Phoenix workflow and domain skills.
• agents/ preserves the upstream specialist agent prompts as reference material.
• .codex-plugin/plugin.json is the Codex plugin manifest.
• NOTICE.md records upstream attribution and porting notes.

What Is Not Included

The upstream Claude plugin includes Claude Code hooks for lifecycle events such as tool-use formatting, session start checks, compaction reminders, and stop handling. Codex plugins do not currently have a drop-in equivalent for those Claude-specific hook events and environment variables, so those hook files are not included in this port.

The practical Codex equivalent is to encode critical behavior in skills, project instructions, and explicit verification workflows. For example, phx-verify handles project-aware compile/format/test discovery, and phx-init installs project guidance into AGENTS.md.

Codex Skill Names

The upstream slash-command style has been converted into Codex skill names:

• phx-plan
• phx-work
• phx-review
• phx-verify
• phx-full
• phx-investigate
• phx-audit
• ecto-n1-check
• lv-assigns

Artifacts that upstream wrote under .claude/ now target .codex/elixir-phoenix/. The project initializer targets AGENTS.md instead of CLAUDE.md.

Install Into Codex

Repo-Local Marketplace

Use this when you want the plugin available for one workspace.

1. Clone this repo into your workspace:

   git clone https://github.com/YOUR-USER/elixir-phoenix-codex.git plugins/elixir-phoenix

2. Add or update .agents/plugins/marketplace.json at the workspace root:

   {
     "name": "local-dev",
     "interface": {
       "displayName": "Local Dev Plugins"
     },
     "plugins": [
       {
         "name": "elixir-phoenix",
         "source": {
           "source": "local",
           "path": "./plugins/elixir-phoenix"
         },
         "policy": {
           "installation": "AVAILABLE",
           "authentication": "ON_INSTALL"
         },
         "category": "Developer Tools"
       }
     ]
   }

3. Restart Codex and install Elixir Phoenix from the local plugin marketplace.

Home-Local Marketplace

Use this when you want the plugin available across workspaces.

1. Clone this repo into your Codex plugin folder:

   git clone https://github.com/YOUR-USER/elixir-phoenix-codex.git C:\Users\[USERNAME]\.codex\plugins\elixir-phoenix

2. Add the same marketplace entry to:

   C:\Users\[USERNAME]\.agents\plugins\marketplace.json
   

   Keep the source path as:

   "path": "./plugins/elixir-phoenix"

3. Restart Codex and install Elixir Phoenix.

Development

The high-traffic skills to review first when updating the port are:

• skills/init/SKILL.md
• skills/plan/SKILL.md
• skills/work/SKILL.md
• skills/review/SKILL.md
• skills/verify/SKILL.md
• skills/full/SKILL.md

See PORTING.md for the conversion rules used to keep this port aligned with upstream.