codex - 💡(How to fix) Fix Add an Agent View for managing multiple Codex agents from the TUI

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

Error Message

  • See each agent's status, such as running, needs input, idle, done, or error.
RAW_BUFFERClick to expand / collapse

What variant of Codex are you using?

CLI

What feature would you like to see?

I would like Codex CLI/TUI to provide an Agent View for managing multiple active and historical agent sessions from one place.

When working with multiple agents in parallel, users currently need to keep track of several sessions manually. This becomes hard when agents are running in different worktrees, waiting for user input, or finishing at different times.

The proposed Agent View would let users:

  • Open a unified agent/session list from the TUI, for example with /agents or an empty-prompt left-arrow shortcut.
  • See each agent's status, such as running, needs input, idle, done, or error.
  • See the last response preview and recent activity time for each agent.
  • Jump directly into an agent session from the list.
  • Include agent sessions discovered from the current app-server and persisted subagent history, not only sessions spawned during the current TUI lifetime.

This would make parallel Codex workflows much easier to operate, especially when a user is delegating multiple independent implementation or investigation tasks.

Additional information

I have a local prototype branch implementing an initial version of this for the Rust TUI.

Current prototype behavior:

  • /agent opens an Agents view.
  • /agents is supported as an alias.
  • Pressing left arrow on an empty prompt reopens the Agent View.
  • The view includes currently loaded threads plus persisted SubAgent sessions from thread/list.
  • Rows show status, relative updated time, and the latest assistant/agent message preview.
  • Enter selects the target agent thread.

Validation run locally:

  • cargo test -p codex-tui agent_view -- --nocapture
  • cargo test -p codex-tui agents_alias_opens_agent_command -- --nocapture
  • just fix -p codex-tui
  • git diff --check

One limitation of the current prototype is that cross-process real-time status still depends on what the current app-server knows. A complete version may need a global session/agent registry so the Agent View can show all running Codex agents across projects and processes with live status.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

codex - 💡(How to fix) Fix Add an Agent View for managing multiple Codex agents from the TUI