README.md

animus-provider-codex

An OpenAI Codex CLI provider plugin for Animus.

Status: Under construction — landing in Animus v0.4.x. This crate currently lives in the Animus core workspace at crates/animus-provider-codex/; v0.4.x extracts it to this standalone repository.

What this is

Animus v0.4.0 makes providers (LLM CLI wrappers) pluggable. This repository will ship animus-provider-codex, a stdio plugin that wraps OpenAI's Codex CLI as an Animus provider. Any workflow phase that targets tool: codex dispatches through this plugin.

Install (planned)

animus plugin install animus-provider-codex

The Animus daemon image bundles this plugin pre-installed.

Workflow YAML usage

agents:
  refactor-specialist:
    model: gpt-5.2
    tool: codex
    mcp_servers: ["animus"]

Roadmap

• Extract from Animus core workspace at v0.4.x cut
• Publish animus-provider-codex crate to crates.io
• Release binaries (macOS aarch64/x86_64, Linux x86_64) on tag
• Independent semver track
• CI exercises the contract test from animus-protocol

Design

• Protocol: animus-plugin-protocol (provider variant)
• Naming: repo, crate, and binary all named animus-provider-codex
• Core repo: Animus

License

MIT — see LICENSE.