Shell snapshot validation fails on macOS Bash (unexpected token '(') – v0.103.0
Resolved 💬 1 comment Opened Feb 18, 2026 by fugamante Closed Feb 20, 2026
What version of Codex CLI is running?
codex-cli 0.103.0
What subscription do you have?
ChatGPT Plus
Which model were you using?
_No response_
What platform is your computer?
Darwin 25.3.0 arm64 arm
What terminal emulator and version are you using (if applicable)?
Terminal.app
What issue are you seeing?
Environment
- macOS (Apple Silicon)
- Bash (Homebrew-installed)
- Codex v0.103.0 (research preview)
- shell_snapshot feature enabled (default)
Issue
Every time codex exec runs, I receive:
ERROR codex_core::shell_snapshot:
Shell snapshot validation failed:
syntax error near unexpected token `('
The referenced snapshot file is immediately deleted,
so it cannot be inspected afterward.
Observations
.bashrccontains no zsh syntax- No
path=(...),setopt,autoload, etc. CODEX_HOMEnot set (default ~/.codex used)- Snapshot directory remains empty
- Codex continues functioning normally
- Disabling
shell_snapshotin ~/.codex/config.toml resolves the issue
[features]
shell_snapshot = false
### What steps can reproduce the bug?
- Download rtk formulae (Homebrew)
- Remove Claude Hooks
- Add this function to .bashrc :
cx() { rtk "$@" | codex exec -; }
- Sourced it, and tested it running :
cx git status
### What is the expected behavior?
In-App Feedback
Sometimes Codex CLI supports:
---
Or there's a link in the CLI banner.
If available, use that too.
---
Shell snapshotting is:
- A performance optimization
- Environment-dependent
- Complex on macOS due to launchd, Homebrew, env vars, functions
### Additional information
_No response_This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗