codex - 💡(How to fix) Fix Adding CLI Option to hide tool activity [1 participants]

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…
GitHub stats
openai/codex#21252Fetched 2026-05-06 06:24:09
View on GitHub
Comments
0
Participants
1
Timeline
8
Reactions
0
Author
Participants
Timeline (top)
labeled ×5unlabeled ×3

Fix Action

Fix / Workaround

The setting only changes what the TUI adds to the visible transcript. Tool calls still run normally, approvals still appear when needed, and user shell commands remain visible. When hiding is enabled, Codex skips inserting agent tool-history cells for exec, MCP, web search, image, patch, and collaboration tool events, while continuing to render reasoning summaries and final assistant messages.

Code Example

[tui]
hide_tool_activity = true

---

cargo test -p codex-core config_toml_deserializes_tui_hide_tool_activity
cargo test -p codex-tui hide_tool_activity_keeps_reasoning_and_answer_visible
cargo test -p codex-tui slash_tool_activity
cargo test -p codex-tui slash_command
RAW_BUFFERClick to expand / collapse

What variant of Codex are you using?

CLI

What feature would you like to see?

Problem

The TUI transcript can become dominated by tool-call cells during long sessions. This makes the conversation hard to scan when the user mainly wants reasoning summaries and final answers.

Proposal

Add an opt-in TUI setting:

[tui]
hide_tool_activity = true

When enabled, Codex hides agent tool activity from the TUI transcript while preserving reasoning summaries, final assistant answers, approvals, and user shell commands.

Also add a live slash command:

  • /tool-activity toggles the setting for the current session.
  • /tool-activity hide
  • /tool-activity show
  • /tool-activity toggle
  • /tool-activity status

How it works

The setting only changes what the TUI adds to the visible transcript. Tool calls still run normally, approvals still appear when needed, and user shell commands remain visible. When hiding is enabled, Codex skips inserting agent tool-history cells for exec, MCP, web search, image, patch, and collaboration tool events, while continuing to render reasoning summaries and final assistant messages.

Prototype

I tested a local prototype on Windows against rust-v0.128.0.

Covered behavior:

  • config TOML deserializes the new setting
  • hidden tool activity does not insert transcript cells
  • reasoning summaries and final answers remain visible
  • slash command toggles the behavior without sending a core op
  • slash-command parsing and recall behavior follow existing patterns

Tests

Focused tests used in the prototype:

cargo test -p codex-core config_toml_deserializes_tui_hide_tool_activity
cargo test -p codex-tui hide_tool_activity_keeps_reasoning_and_answer_visible
cargo test -p codex-tui slash_tool_activity
cargo test -p codex-tui slash_command

Additional information

I realised this implementation locally with codex itself and it showed significant visual clarity improvements.

<img width="1265" height="306" alt="Image" src="https://github.com/user-attachments/assets/d4fcc410-b585-4e82-8881-817c7e6c6472" />

extent analysis

TL;DR

To address the issue of the TUI transcript being dominated by tool-call cells, add a TUI setting hide_tool_activity and implement a slash command /tool-activity to toggle this setting.

Guidance

  • Implement the proposed TUI setting hide_tool_activity in the toml configuration file to hide agent tool activity from the TUI transcript.
  • Add a slash command /tool-activity with options to toggle, hide, show, or check the status of tool activity visibility.
  • Ensure that the implementation preserves reasoning summaries, final answers, approvals, and user shell commands in the transcript.
  • Test the implementation using focused tests, such as cargo test -p codex-core config_toml_deserializes_tui_hide_tool_activity and cargo test -p codex-tui hide_tool_activity_keeps_reasoning_and_answer_visible.

Example

[tui]
hide_tool_activity = true

This example shows how to enable the hide_tool_activity setting in the toml configuration file.

Notes

The proposed solution is based on the provided prototype and tests, which were implemented locally using Codex itself. The implementation may require additional testing and refinement to ensure it works as expected in different scenarios.

Recommendation

Apply the proposed workaround by implementing the hide_tool_activity setting and the /tool-activity slash command, as it provides a clear and effective solution to the problem of tool-call cells dominating the TUI transcript.

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 Adding CLI Option to hide tool activity [1 participants]