[BUG] bash: line 1: applypatch: command not found

Resolved 💬 12 comments Opened Aug 9, 2025 by vitatea2023 Closed Aug 14, 2025
💡 Likely answer: A maintainer (dylan-hurd-oai, contributor) responded on this thread — see the highlighted reply below.

What version of Codex is running?

codex-cli 0.20.0

Which model were you using?

gpt-5

What platform is your computer?

Linux 6.14.9-arch1-1 x86_64 unknown

What steps can reproduce the bug?

It is common to use GPT-5 programming in daily life

What is the expected behavior?

Normal implementation of replacing text

What do you see instead?

<img width="3448" height="1914" alt="Image" src="https://github.com/user-attachments/assets/832399d9-9830-43c5-9bf8-2d28fdd03df9" />

Additional information

_No response_

View original on GitHub ↗

12 Comments

vitatea2023 · 11 months ago

@bolinfest

vitatea2023 · 11 months ago

The lack of underscores for calling may be a manifestation of reinforcement learning. It is recommended to remove underscores from the source code, as modifying the source code is much easier than modifying the model.

vitatea2023 · 11 months ago

@easong-openai

vitatea2023 · 11 months ago

I use this in ~/.codex/AGENTS.md and it works good

**AGENTS Usage Guide — About `apply_patch`**

- **Purpose:** Ensure the model uses the correct patch‑tool name when modifying the workspace, avoiding misuse that leads to errors or confusion.

- **Never use:** `applypatch` or `apply-patch` (without the underscore). These commands do not exist in the system and will result in “command not found” errors.

- **Correct usage (must include the underscore):** `apply_patch`.

- **Recommended examples (patch‑call examples for the model’s reference):**

  1. **Patch format to modify a file**

     ```
     *** Begin Patch
     *** Update File: path/to/file.txt
     @@
     -old line
     +new line
     *** End Patch
     ```

  2. **Calling it from the shell (handled by the execution environment)**

     ```json
     shell {"command":["apply_patch","*** Begin Patch\n*** Update File: path/to/file.txt\n@@\n-old line\n+new line\n*** End Patch\n"]}
     ```

- **Note:** Always write the underscore (`_`) explicitly. If you encounter `applypatch` or `apply-patch`, replace it with `apply_patch`.

- **Why this matters:** Using the correct name guarantees that the patch is applied properly and prevents unnecessary execution errors.
liarco · 11 months ago
I use this in ~/.codex/AGENTS.md and it works good AGENTS Usage Guide — About apply_patch - Purpose: Ensure the model uses the correct patch‑tool name when modifying the workspace, avoiding misuse that leads to errors or confusion. - Never use: applypatch or apply-patch (without the underscore). These commands do not exist in the system and will result in “command not found” errors. - Correct usage (must include the underscore): apply_patch. - Recommended examples (patch‑call examples for the model’s reference): 1. Patch format to modify a file `` *** Begin Patch *** Update File: path/to/file.txt @@ -old line +new line *** End Patch ` 2. **Calling it from the shell (handled by the execution environment)** `json shell {"command":["apply_patch","*** Begin Patch\n*** Update File: path/to/file.txt\n@@\n-old line\n+new line\n*** End Patch\n"]} ` - **Note:** Always write the underscore (_) explicitly. If you encounter applypatch or apply-patch, replace it with apply_patch`. - Why this matters: Using the correct name guarantees that the patch is applied properly and prevents unnecessary execution errors.

I was writing a reply about this exact solution when your latest message appeared. I can confirm that this solution works great, at least as a temporary measure. It also significantly reduces the number of wasted API calls and tokens.

vitatea2023 · 11 months ago

@dylan-hurd-oai @gpeal

vitatea2023 · 11 months ago

@ae-openai

vitatea2023 · 11 months ago

@pakrym-oai

dylan-hurd-oai contributor · 11 months ago

Please refrain from tagging contributors - we do monitor this! This should be resolved by #2186

frixaco · 9 months ago

This still seems to be not fully resolved. I just installed latest codex CLI, all default settings, using API key, WSL2/Arch. I got this error while codex was trying to edit a Swift file. Happy to provide more info if needed.

monneyboi · 9 months ago

I just ran into this as well. On Arch linux, using openai API key with codex-cli 0.19.0

bolinfest collaborator · 9 months ago

@monneyboi The current version of Codex is 0.47.0: please upgrade!