Conversation
Add the new CLI hooks guide under docs/cli so it can be linked from the navigation update in the next commit.
Add the new CLI hooks page to the CLI section in docs/docs.json so it appears in the published documentation navigation.
dosubot
bot
added
the
size:L
|
All contributors have signed the CLA ✍️ ✅ |
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 69ab972a31
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
docs/cli/hooks.mdx
Outdated
|
|
||
| ## Event types | ||
|
|
||
| These are the event names currently supported by the CLI hooks system: |
There was a problem hiding this comment.
This section says the listed events are “currently supported,” but several listed events are not emitted by the CLI runtime (for example PermissionRequest, SubagentStart, ConfigChange, and TaskCompleted): in extensions/cli/src/hooks/fireHook.ts there are no emitters for those events, and repo-wide usage shows no other services.hooks.fireEvent(...) call sites outside that helper file. As written, users can configure these events and never see hooks run, so the guide should mark them as planned/schema-only or remove them from the supported table.
Useful? React with 👍 / 👎.
There was a problem hiding this comment.
Addressed in 702698a. I updated the guide to list only the events the CLI actually emits today and explicitly marked the extra Claude-compatible event names as reserved/not emitted yet.
![cubic-dev-ai[bot]](https://avatars.githubusercontent.com/in/1082092?s=60&v=4){kind=small}
|
I have read the CLA Document and I hereby sign the CLA |
|
recheck |
1 participant
Description
Closes #11221.
This adds a new CLI hooks guide that documents configuration locations, supported hook and event types, blocking behavior, and a couple of end-to-end examples. It also links the page from the CLI docs navigation so the guide shows up in the published sidebar. The change is intentionally small and safe because it only adds documentation plus a single docs navigation entry, with no runtime or config behavior changes.
Checklist
Tests
npx --yes prettier --check --no-config --tab-width 2 --use-tabs false --trailing-comma all --semi true --single-quote false --bracket-spacing true docs/cli/hooks.mdx docs/docs.jsonnpx mintlify broken-linksWhy this is small and safe
Summary by cubic
Adds a CLI Hooks guide covering config precedence, hook and event types, blocking behavior, and two examples. Clarifies which events the CLI emits today vs. reserved Claude-compatible events, and links the page in the CLI docs navigation; fulfills Linear #11221.
Written for commit 702698a. Summary will update on new commits.