Skip to main content

Codexy

Codexy is a Codex harness for coordinating agents through planning, implementation, verification, and review.

It helps Codex turn a broad repository request into an owned plan, divide work among agents, implement changes, verify actual outcomes, and keep the next handoff tied to current evidence.

Components

Codexy is delivered as three cooperating components. github and devtools each depend on core; the installer adds those dependencies automatically.

Component Plugin What it adds
core codexy Orchestration, finite goals and plans, worktree ownership, specialist roles, instruction hooks, and proof-driven completion.
github codexy-github Issue-to-merge workflows for branches, pull requests, CI, review feedback, releases, and GitHub safety checks.
devtools codexy-devtools Local Codegraph and LSP servers, configuration, wrappers, and developer-tool guidance.

The component model lets each repository install the capabilities it needs without losing a single ownership and verification contract.

Install

Install the getcodexy command, then install the complete Codexy product:

uv tool install getcodexy
uv tool update-shell

Start a new shell so the updated tool path is available, then install Codexy:

getcodexy install

The default selection installs core, github, and devtools. To choose a smaller dependency closure, name the optional components you need:

getcodexy install core
getcodexy install github
getcodexy install devtools
getcodexy install github devtools

Open a fresh Codex session after installation or update so the host can expose the installed plugins, skills, agents, hooks, and MCP servers.

Maintain and check Codexy

Keep the installer and installed component selection current, inspect health, or remove an optional component:

uv tool upgrade getcodexy
getcodexy update
getcodexy status
getcodexy doctor
getcodexy remove github

status reports the installed inventory and its consistency. doctor checks host readiness and the health of each installed component. Update and removal operations preserve the dependency closure and reject inconsistent selections.

Project links

Metadata

Release files for getcodexy 1.8.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for getcodexy 1.8.0
File Size Uploaded Provenance
getcodexy-1.8.0.tar.gz 83.1 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for getcodexy 1.8.0
File Interpreter ABI Platform
getcodexy-1.8.0-py3-none-any.whl Python 3 none any Details

Total release size: 207.8 kB

Release files / getcodexy-1.8.0.tar.gz

Download URL getcodexy-1.8.0.tar.gz
Size 83.1 kB
Tags Source
SHA-256 checksum
How to use checksums
12f20afc214a528477beb1e1b2aa8f758e173756c237750f52b4fd623be405bd
BLAKE2b-256 checksum
How to use checksums
b0f76617122cbd5804f4269d58784f46770fdd11dd192db828ac765c39560753
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 13, 2026.

Transparency log

Release files / getcodexy-1.8.0-py3-none-any.whl

Download URL getcodexy-1.8.0-py3-none-any.whl
Size 124.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
882dfd0016062d9119c7014e286eec6dfe550106aec3dbbd141120178518eafc
BLAKE2b-256 checksum
How to use checksums
ce6ebf91c2903844f3b8c18c5a3c2eeaa15f25c49f5a467f9c09cf49c26b3ba8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 13, 2026.

Transparency log

Security for getcodexy 1.8.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for getcodexy-1.8.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 13, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page