allox 0.1.1

A reusable Codex-supervised framework for bootstrapping and maintaining AI-native product repositories.

allox

allox is a reusable framework product for bootstrapping and maintaining Codex-led development repositories, with Codex as the normal development surface and background review orchestration handled behind the scenes.

Install

From PyPI after the first release:

uv tool install allox

From Git before the first release:

uv tool install git+https://github.com/ryanlatham/allox

For local development from a checkout:

uv sync
uv run allox --help

Quick start

From a local checkout, prefix CLI commands with uv run. From an installed tool, call allox directly.

uv run allox doctor
uv run allox doctor --online
uv run allox new my-project --init-git
cd my-project

You can also run allox new with no path to scaffold the current working directory.

Then open the generated project in Codex and work normally from your task, issue, or product spec.

The generated project contract lets Codex bootstrap tasks and run the managed allox workflow behind the scenes.

Commands

• allox new [path] bootstraps a new project from the default template and aborts before writing if it detects file or folder conflicts. If path is omitted, it uses the current working directory.
• allox new [path] --dry-run previews the planned create and append actions without writing anything.
• allox doctor checks local prerequisites and project health.
• allox doctor --online checks provider-authenticated readiness for Codex plus the managed background reviewers.
• allox upgrade [path] safely updates managed framework files.
• allox self-test renders a temp project and validates the scaffold.

Runtime discovery notes

allox supports ALLOX_CODEX_BIN, ALLOX_CLAUDE_BIN, and ALLOX_GEMINI_BIN, and it also auto-discovers common user installs such as ~/.nvm/versions/node/*/bin/gemini.

If a wrapper binary lives outside the current non-interactive PATH, allox will prepend the discovered parent directory for child commands automatically. allox is project-scoped and does not write user-level instruction files.

See docs/install.md, docs/development.md, docs/publishing.md, docs/quickstart.md, and docs/architecture.md for more detail.