Plan output prints raw :codex-file-citation markup instead of rendering a link

Open 💬 0 comments Opened Aug 25, 2026 by zhouzhendiao

What version of Codex CLI is running?

codex-cli 0.149.1

What issue are you seeing?

When Codex CLI displays a plan in the terminal, a file citation inside the plan is printed as raw internal markup instead of being rendered as a clickable file link.

Example output:

- :codex-file-citation{path="filepath" purpose="output"}

This appears to be specific to the plan text rendering path.

What steps can reproduce the bug?

  1. Run Codex CLI in a terminal.
  2. Have Codex produce a plan that references an output file.
  3. Observe the file citation shown in the plan.

What is the expected behavior?

The file citation should render as a clickable file link in plan output, consistent with supported file-link rendering elsewhere. If plan output cannot render file citations, Codex should fall back to a normal Markdown link or readable path.

What is the actual behavior?

The terminal prints the literal :codex-file-citation{...} directive in the plan text.

Additional information

Related: #35397 reports the same raw markup in ordinary final responses on Codex CLI 0.145.0. This report is specifically about the plan-output rendering path and reproduces on 0.149.1.

Platform and terminal emulator were not included in this report.

View original on GitHub ↗