Skip to content

Commit ced5aa1

Browse files
authored
Merge pull request #5252 from JSap0914/docs/4722-codex-hook-code1
docs(codex): add hook code 1 recovery note
2 parents 193300c + 86241c2 commit ced5aa1

1 file changed

Lines changed: 1 addition & 0 deletions

File tree

docs/guide/installation.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -747,6 +747,7 @@ The Codex CLI Light edition is fully independent of the OpenCode plugin. You can
747747
| `Ignoring malformed agent role definition: agents.*.config_file must point to an existing file` | Re-run `npx lazycodex-ai install`. The installer repairs stale managed `[agents.*]` entries and recreates `~/.codex/agents/*.toml`. |
748748
| `agents.max_threads cannot be set when multi_agent_v2 is enabled` in one project | Re-run `npx lazycodex-ai install` from that project. The installer repairs project-local `.codex/config.toml` layers, creates `.backup-<timestamp>` files for changed configs, and leaves user-authored `.codex` artifacts in place. |
749749
| `SessionStart hook (failed)` / `UserPromptSubmit hook (failed)` with `MODULE_NOT_FOUND` for `components/*/dist/cli.js` | Re-run the installer so the cached plugin is rebuilt with component `dist/` files. If the cache was manually edited, remove `~/.codex/plugins/cache/sisyphuslabs` first. |
750+
| `SessionStart hook (failed)` / `UserPromptSubmit hook (failed)` with only `hook exited with code 1` after install | Re-run `npx lazycodex-ai install`, then start a fresh Codex session or restart the Codex app. If the same hook fails again in the fresh session, inspect the saved hook output to identify the component command before deleting cache state. |
750751
| Hook trust hash mismatch warnings | Re-run the installer; hashes are regenerated each install |
751752
752753
### Step 8: Team Mode (optional, opt-in)

0 commit comments

Comments
 (0)