Linuxbrew-installed tmux is missing from trusted helper lookup, disabling terminal pets

Đang mở Phù hợp với người mới
#62,005 1 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
72/100
Loại issue
Lỗi
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
linux, rust
Lĩnh vực
cli, tooling

Hướng nghiên cứu

Đọc utils/path-utils/src/system_commands.rs, đặc biệt là system_directories() và installation_roots(), rồi lần theo cách system_executable("tmux") xác thực các đường dẫn. Kiểm tra các bài kiểm tra hiện có về việc tìm kiếm chương trình trợ giúp đáng tin cậy và bổ sung kiểm thử cho các tệp thực thi nằm dưới tiền tố Homebrew tiêu chuẩn trên Linux. Công việc hoàn tất khi có thể tìm thấy tmux của Linuxbrew và chính sách về chương trình trợ giúp đáng tin cậy vẫn được thực thi.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

bug CLI pets TUI
What version of Codex CLI is running?

codex-cli 0.169.0 (also the npm latest version when checked on November 17, 2026).

What subscription do you have?

Not included; this failure occurs during local terminal capability detection.

Which model were you using?

The identified failure is in local TUI startup/helper discovery, before a model response is needed.

What platform is your computer?

Ubuntu 26.04.1 LTS, x86_64.

Linux 7.0.0-43-generic x86_64 unknown
What terminal emulator and version are you using?

Ghostty 1.4.0, with tmux 3.8 installed through Homebrew on Linux.

Codex doctor report

Relevant excerpt from codex doctor --json, collected in a noninteractive diagnostic subprocess:

{
  "codexVersion": "0.169.0",
  "installation": {
    "current executable": "/home/linuxbrew/.linuxbrew/Caskroom/codex/0.169.0/bin/codex"
  },
  "terminal.env": {
    "terminal": "Ghostty",
    "tmux options": "not inspected (PATH helpers are not executed)"
  }
}
What issue are you seeing?

Terminal pets do not appear inside tmux even with fullscreen Codex, allow-passthrough all, and a selected pet (rocky). The tmux session reports Ghostty and RGB support.

The installed tmux is discoverable from the shell:

$ command -v tmux
/home/linuxbrew/.linuxbrew/bin/tmux
$ readlink -f /home/linuxbrew/.linuxbrew/bin/tmux
/home/linuxbrew/.linuxbrew/Cellar/tmux/3.8/bin/tmux

There is no tmux executable in the trusted search locations on this machine.

Live tmux state:

$ tmux display-message -p 'fullscreen=#{alternate_on} passthrough=#{allow-passthrough} terminal=#{client_termname} type=#{client_termtype}'
fullscreen=1 passthrough=all terminal=xterm-ghostty type=ghostty 1.4.0

#{client_termfeatures} also includes RGB.

What steps can reproduce the bug?
  1. On Linux, install tmux through Homebrew into /home/linuxbrew/.linuxbrew, without another tmux installation in the trusted system locations.
  2. Start tmux in Ghostty or Kitty.
  3. Set and apply set -g allow-passthrough all in tmux.
  4. Enable fullscreen_transcript = true under [tui] in Codex's configuration.
  5. Start Codex CLI 0.169.0 and select a terminal pet, for example /pets rocky.
  6. Observe that pets remain unavailable despite the supported terminal, fullscreen mode, and passthrough setting.
What is the expected behavior?

Codex should discover a tmux installation under the standard Linux Homebrew prefix and enable pets when the other capability checks pass. If that installation is intentionally unsupported, the diagnostic should explain the helper-discovery failure rather than only suggesting fullscreen/passthrough settings that are already enabled.

Additional information

Source inspection in the rust-v0.169.0 tag identifies the failing lookup:

  • tui/src/tui/tmux.rs calls system_executable("tmux") and returns default options when it cannot find the helper. That leaves kitty_image_base unset.
  • utils/path-utils/src/system_commands.rs deliberately ignores ambient PATH. Its system_directories() and installation_roots() include macOS Homebrew locations but omit /home/linuxbrew/.linuxbrew/bin and /home/linuxbrew/.linuxbrew.
  • The helper lookup canonicalizes executable paths before validating them, so a symlink in /usr/local/bin pointing to the Linuxbrew installation would still be rejected.
  • pets/image_protocol.rs only enables the tmux pet protocol when the fullscreen image base is available.

The trusted-helper policy was introduced in #42324. This report concerns coverage of the standard Linux Homebrew prefix while preserving that policy.

The cause above is based on source inspection and the installed executable paths. Installing/copying tmux into another location has not been tested as a workaround.

Ngôn ngữ chính
Rust
Star
135k
Fork
21.4k
Merge trung bình
1 phút
Pull request đã merge (30 ngày)
998

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của openai/codex

Tất cả issue của openai/codex

Issue tương tự

Thêm issue về Rust

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.