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

Abierto Apto para principiantes
#62,005 1 comentario 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
72/100
Tipo de issue
Error
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
linux, rust
Área
cli, tooling

Línea de trabajo

Lee utils/path-utils/src/system_commands.rs, especialmente system_directories() e installation_roots(), y luego sigue cómo system_executable("tmux") valida las rutas. Revisa las pruebas existentes para la búsqueda de herramientas auxiliares de confianza y añade cobertura para ejecutables bajo el prefijo estándar de Homebrew en Linux. El trabajo estará terminado cuando se pueda encontrar Linuxbrew tmux y se siga aplicando la política de herramientas auxiliares de confianza.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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.

Lenguaje dominante
Rust
Estrellas
135k
Forks
21.4k
Merge medio
1 min
PR fusionados (30 d)
998

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de openai/codex

Todos los issues de openai/codex

Issues similares

Más issues de Rust

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.