Repository navigation
Conversation
Replace the deprecated V1 configuration in install and runtime guidance. Document the V2 session cap and account for optional Codex tools so pstack can select native lanes from the active tool surface. Closes ericlitman#298.
Author
Codex multi-agent v2 guidanceEvidence
Proposed changes
Verification
Checklist
Outcome
|
Contributor
Merge Protections🟠 1 of 2 protections blocking · waiting on 🤖 CI
🟠 Queue ready pull requestsWaiting for
Waiting checks:
|
Keep installation and tool guidance focused on the current V2 setting. Remove migration background from the user-facing setup pages.
Add the opt-in task plan setting beside the V2 setup example. Remove the close-agent mapping because V2 does not expose that tool.
Clarify instructions for enabling Codex subagents.
oppegard
marked this pull request as ready for review
November 16, 2026 22:01
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Using
multi_agentin Codex now issues warnings (see screenshot below). Migrate tomulti_agent_v2.close_agentrow because V2 does not expose it.OpenAI Codex stabilized V2 with opt-in enablement, defined its session cap, and made
update_planopt-in. Its V2 tool registration omitsclose_agent.Closes #298.
Approved plan and current checklist.
Checks
bun run test: 509 passed with the inheritedCODEX_SANDBOX_NETWORK_DISABLEDhint removed from the test process.bun run typecheck: passed.bun run static: passed, including 219 verifier tests.claude plugin validate plugins/pstack: passed.claude plugin validate .claude-plugin/marketplace.json: passed.Exact-head live verification
c33d5c7in an isolated Codex home using the README's exact TOML block. Installed skill and reference hashes match the candidate.poteto-modesession read the installed tool reference. Codex accepted the README block under strict config parsing, calledupdate_plan, and completed both task steps. The installed V2 tool list and tool reference had noclose_agent.update_planpath. Its native V2 child probe dispatchedcodex:gpt-6.1-sol@high, read a private marker, and returned the matching value.verify-open-pstackstopped before its cases withRequire an open same-repository PR. This fork PR has nolive-gatestatus.This PR stays draft. Its repository gate needs a same-repository branch or a verifier change before merge. Merge also needs user approval.
Screenshot of
multi_agentwarning