Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
45 changes: 45 additions & 0 deletions agent-pack/platforms/codex/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,51 @@ The `AGENTS.md` content is a pointer to merge into the target repository's
project instructions. This package does not provide an installer, write to
`~/.codex`, or claim Desktop support.

## Codex CLI 0.149.0 native capabilities

The following provider-native commands are bounded execution and diagnostic
surfaces. They do not become NeuralEngine authority.

### Optional provider preflight: `codex doctor --json`

`codex doctor --json` emits a redacted machine-readable report that may provide
evidence about Codex installation and runtime provenance, configuration
parsing, app-server state, sandbox and approval policy, provider/network
readiness, local state/database health, and environment or update state.

It is an optional provider-side preflight. A healthy result does not replace
`neural status`, verification of `AGENTS.md` or NeuralEngine skill discovery,
NeuralEngine Brain/provenance checks, or live model/session validation.

### Session browser: `codex agents`

`codex agents` browses agent sessions on the shared local app-server daemon. It
is not a NeuralEngine role registry and does not define or map `builder`,
`reviewer`, `planner`, or `mechanical` responsibilities. It is not a task
delegation, permission-isolation, concurrency, or review-workflow contract.

### Existing-session continuation: `codex queue`

`codex queue --thread <THREAD> --message <TEXT>` queues a message to an
existing session or thread. The observed command surface does not establish
workflow scheduling, dependency handling, retry or cancellation semantics,
ownership, role transitions, review-artifact generation, Brain-write
authorization, or publication authorization.

Queue-based workflow automation remains `HOLD` pending a separate bounded
runtime validation. Do not use it to turn a builder continuation into a
reviewer, authorize Brain writes, or imply staging, commit, push, merge, tag,
release, or publication.

## NeuralEngine authority boundary

`AGENTS.md` remains the project-instruction authority and
`agent-pack/shared/neuralengine.md` remains the semantic authority. The Codex
skill is a controlled projection of that shared contract. `neural status`,
relevance-gated `neural knowledge search/show`, the read-only Brain default,
explicit Brain-write authorization, and separate publication authorization
remain unchanged.

## Limitations

- Codex CLI is the only supported surface in this adapter.
Expand Down