Skip to content

docs: add codex-axi to community catalog - #98

Open
kyler505 wants to merge 1 commit into
kunchenguid:mainfrom
kyler505:codex-axi-catalog
Open

docs: add codex-axi to community catalog#98
kyler505 wants to merge 1 commit into
kunchenguid:mainfrom
kyler505:codex-axi-catalog

Conversation

@kyler505

Copy link
Copy Markdown

Intent

Add codex-axi to the AXI community catalog as an alpha Codex orchestration CLI, preserving its current Codex and SDK compatibility range.

What Changed

  • Added a codex-axi entry to catalog.yaml, marked alpha with its current Codex and SDK compatibility range.
  • Regenerated the generated:... catalog regions in README.md and docs/index.html from catalog.yaml to include the new entry.

Risk Assessment

✅ Low: Purely additive, mechanical documentation change (README.md, catalog.yaml, docs/index.html) adding one catalog entry; all three generated/single-sourced locations are consistently updated and the entry correctly states alpha status and Codex 0.144.x compatibility per the required intent, with no code or behavior changes.

Testing

docs:check confirms the generated README/docs/index.html tables were regenerated correctly from catalog.yaml (no drift) and the generator's unit tests pass, giving direct evidence the new codex-axi catalog entry — including its alpha status and Codex 0.144.x compatibility note — renders correctly in both end-user-facing docs surfaces.

Pipeline

Updates from git push no-mistakes

✅ **intent** - passed

✅ No issues found.

✅ **Rebase** - passed

✅ No issues found.

✅ **Review** - passed

✅ No issues found.

✅ **Test** - passed

✅ No issues found.

  • pnpm run docs:check (via npx pnpm on system Node 25) — confirms README.md and docs/index.html generated regions exactly match catalog.yaml
  • pnpm run docs:test (node --test scripts/generate-docs.test.mjs) — 4/4 generator unit tests pass
  • Manual diff review of git show HEAD for catalog.yaml, README.md, docs/index.html to confirm the codex-axi entry (alpha, Codex 0.144.x compatibility) is present verbatim in all three files
✅ **Document** - passed

✅ No issues found.

✅ **Lint** - passed

✅ No issues found.

✅ **Push** - passed

✅ No issues found.

@kunchenguid

kunchenguid commented Jul 21, 2026

Copy link
Copy Markdown
Owner

Automated reminder: thanks for the PR! This branch currently has a merge conflict with the base branch.

When you get a chance, please rebase onto (or merge) the latest base branch, resolve the conflict, and push. After that, checks will re-run and the PR will get looked at again.

Noted for axi#98 at 19057b7f.

@kyler505
kyler505 force-pushed the codex-axi-catalog branch 2 times, most recently from 0ec31e9 to 11a499f Compare July 22, 2026 01:06
@kunchenguid kunchenguid removed the wheelhouse:pending-contributor-action Managed by Wheelhouse label Jul 22, 2026
@kunchenguid

kunchenguid commented Jul 22, 2026

Copy link
Copy Markdown
Owner

Automated reminder: thanks for the PR! This branch currently has a merge conflict with the base branch.

When you get a chance, please rebase onto (or merge) the latest base branch, resolve the conflict, and push. After that, checks will re-run and the PR will get looked at again.

Noted for axi#98 at 11a499ff.

@kunchenguid

Copy link
Copy Markdown
Owner

Speaking as Kun's firstmate: I reviewed the diff (catalog.yaml plus generated README.md / docs/index.html only) and independently inspected the package.

Independent source review at pin 081806259a6bea595b3d8d94759de2855eddcd4d (current main HEAD; no tags). Files/paths read at that revision: pyproject.toml, src/codex_axi/cli.py, src/codex_axi/output.py, src/codex_axi/integrations.py, src/codex_axi/__init__.py, tests/test_integrations.py, plus the recursive tree. Direct observations at that revision:

  • Python CLI; stdout encoded by a local TOON v3.3 encoder in output.py with --json opt-in; openai-codex>=0.144,<0.145; package classifier Alpha
  • commands include task (start/list/view/steer/interrupt/resume/…), worker, agent, delegate, doctor, daemon, setup hooks, cleanup; generated skills/codex-axi/SKILL.md exists
  • principle 7 held: codex-axi setup hooks writes SessionStart hooks for Claude Code, Codex, and OpenCode (integrations.py)
  • no-args home is a live dashboard (bin + description + app.dashboard()), not help
  • unknown flags fail with a structured AxiError (exit 2)
  • principle 10 not held: -v / -V / --version are not registered. cli.py has no version flag; parse_known_args treats --version as an unknown flag. __version__ = "0.1.0" exists in __init__.py but is not wired to the CLI. AXI principle 10 requires -v, -V, and --version to print the bare version and exit 0.

Catalog description (start/observe/steer/interrupt/resume, worker control, TOON, opt-in ambient integrations, Alpha, Codex 0.144.x) is otherwise source-backed at this pin.

VISION.md per-rule:

  • AXI principles: does not align for a positive admission — principle 10 version flags are absent at this pin.
  • Catalog: cannot tell / not admitted. VISION.md requires the inspected source to satisfy applicable AXI principles before a positive verdict. I will not merge this entry until -v/-V/--version print the bare version and exit 0.
  • SDKs: aligns (docs-only catalog add; no SDK change).

Fork CI (no-mistakes, docs-check, generated-files) is green. The PR is CONFLICTING with main; I am not resolving conflicts because it is not otherwise auto-merge-ready. If you later pin a revision that holds principle 10, re-request review.

@kunchenguid kunchenguid left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Speaking as Kun's firstmate: catalog-only diff, no security issue. Package is not admitted at the inspected pin (see comment).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants