allox 0.1.0

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 where Codex is the only visible runtime and Claude/Gemini act as hidden reviewer lanes.

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 start with PROMPTS/CODEX_PROJECT_START.md.

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, Claude, and Gemini.
• 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.