close_agent is missing from the VS Code multi-agent tool schema
Nobody has claimed this yet.
Assessment
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Newbie friendliness
- 64/100
Research direction
Reproduce the issue with multi_agent enabled in ~/.codex/config.toml and the VS Code Remote - WSL setup, then search the Rust and VS Code extension code for the collaboration-tool schema and close_agent. Trace why the callable schema omits that operation. Done means a new chat exposes the complete lifecycle, including close_agent, with coverage for the reported workflow if the existing test structure supports it.
Written by the indexing model from the issue text.
Description
What version of the IDE extension are you using?
26.721.41059
What subscription do you have?
ChatGPT Plus
Which IDE are you using?
Visual Studio Code 1.131.0 using Remote - WSL
What platform is your computer?
Microsoft Windows NT 10.0.19045.0 x64
What issue are you seeing?
In new Codex chats opened through the VS Code extension, close_agent is missing from the callable collaboration-tool schema even though multi_agent is enabled.
The affected sessions expose:
spawn_agentfollowup_tasksend_messageinterrupt_agentlist_agentswait_agent
They do not expose close_agent.
This is partial tool exposure: multi-agent support is available, but the operation needed to close a completed subagent is missing. interrupt_agent is not a replacement because it only interrupts the agent's current turn and explicitly leaves the agent available.
The issue persists after updating the extension, completely restarting VS Code, and creating multiple brand-new chats.
What steps can reproduce the bug?
-
Enable multi-agent support in
~/.codex/config.toml:[features] multi_agent = true -
Restart VS Code and open a Git repository through Remote - WSL.
-
Open a new Codex chat and send this exact request:
Use a subagent to list the repository's top-level files. Wait for the subagent to finish, close it using close_agent, and report the lifecycle operations you performed. -
Observe that the session can access
spawn_agentandwait_agent, but cannot perform the requested cleanup becauseclose_agentis absent from its callable tool schema. The available cleanup-adjacent operation isinterrupt_agent, which interrupts the current turn but leaves the agent available.
What is the expected behavior?
With stable multi_agent enabled, every new VS Code Codex chat should receive the complete documented collaboration lifecycle, including a callable close_agent operation.
A workflow should be able to:
- spawn a child agent;
- wait for its result;
- explicitly close the child;
- verify that the child reached a terminal state and its slot was reclaimed.
If close_agent has intentionally been replaced, the extension should expose and document an equivalent finalization operation. interrupt_agent should not be treated as equivalent to lifecycle closure.
Additional information
The Codex runtime bundled with the affected extension reports:
codex-cli 0.146.0-alpha.3.1
Relevant configuration:
[features]
multi_agent = true
The VS Code workspace is opened through Remote - WSL with Ubuntu 24.04.4 LTS. The Windows host platform is recorded in the dedicated platform field above.
- Dominant language
- Rust
- Stars
- 125k
- Forks
- 19.5k
- Avg merge
- 1m
- Merged PRs (30d)
- 1k
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from openai/codex
-
enhancement remote
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
-
bug CLI windows-os
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
-
macOS sandbox blocks hw.optional.arm64 sysctl, causing Flutter to misdetect Apple Silicon as x64 Openbug CLI sandbox
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
bug CLI TUI
Difficulty 2/5 1-3 hours Newbie friendliness 90/100
-
CLI config enhancement skills
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 86/100
kwakseongjae/auto-hwp#319 ·
-
area:cli bug filter-quality good first issue priority:medium
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
-
Difficulty 1/5 Under an hour Newbie friendliness 72/100
bevyengine/bevy#25861 ·
-
comp-datalake
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
ClickHouse/ClickHouse#121222 ·
-
A-linter
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
oxc-project/oxc#26863 ·