Skip to content

docs(notifications): remove outdated pre-0.60 Claude Code hooks section - #2036

Closed
BillionClaw wants to merge 1 commit into
manaflow-ai:mainfrom
BillionClaw:clawoss/docs/cmux-2009-remove-outdated-claude-hooks
Closed

BillionClaw wants to merge 1 commit into
manaflow-ai:mainfrom
BillionClaw:clawoss/docs/cmux-2009-remove-outdated-claude-hooks

Conversation

@BillionClaw

@BillionClaw BillionClaw commented Mar 24, 2026 •

Copy link
Copy Markdown
Contributor

The Claude Code hooks section in the notifications docs documented manual JSON hook configuration for idle and permission prompts. This was relevant before 0.60.0.

Since PR #247 (released in 0.60.0), Claude Code integration is enabled by default — cmux automatically wraps the claude command to inject notification hooks. Users on 0.60+ no longer need this manual configuration, so the section is misleading and has been removed.

Fixes #2009.


Summary by cubic

Removed the outdated pre-0.60 Claude Code hooks section from the notifications docs to avoid misleading setup steps. Since 0.60.0, cmux auto-wraps the claude command to inject notification hooks, so manual JSON config is unnecessary—fixes #2009.

Written for commit d57f7cb. Summary will update on new commits.

Summary by CodeRabbit

  • Documentation
    • Removed the Claude Code Hooks integration section from the notifications documentation, including configuration guidelines.

The Claude Code hooks section documented manual JSON configuration for
notification hooks. Since PR manaflow-ai#247 (released in 0.60.0), Claude Code
integration is enabled by default — cmux automatically injects notification
hooks when the claude command is invoked. This manual configuration is no
longer needed and is misleading for users on 0.60+.
@vercel

vercel Bot commented Mar 24, 2026

Copy link
Copy Markdown

@BillionClaw is attempting to deploy a commit to the Manaflow Team on Vercel.

A member of the Team first needs to authorize it.

@coderabbitai

coderabbitai Bot commented Mar 24, 2026 •

Copy link
Copy Markdown

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 7162ef6c-310b-4ea9-9984-cc1ff9341b3e

📥 Commits

Reviewing files that changed from the base of the PR and between 22c50a4 and d57f7cb.

📒 Files selected for processing (1)
  • docs/notifications.md
💤 Files with no reviewable changes (1)
  • docs/notifications.md

📝 Walkthrough

Walkthrough

This PR removes the outdated "Claude Code Hooks" integration section from the notifications documentation. The section contained configuration instructions for versions prior to 0.60.0 that are no longer relevant following the architectural changes introduced in that release.

Changes

Cohort / File(s) Summary
Documentation Cleanup
docs/notifications.md
Removed deprecated "Claude Code Hooks" integration section including configuration instructions and JSON snippets (31 lines deleted).

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

  • #1388: Modifies Claude hooks schema in the same documentation section to align with structural changes.
  • #821: Adds and modifies Claude hook implementation code corresponding to the documentation being removed here.

Poem

🐰 Old hooks retire with grace so fine,
Pre-0.60 docs now align,
Cleaned-up pages, fresh and bright,
Hopping forward into light! ✨

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly and specifically describes the main change: removing outdated pre-0.60 Claude Code hooks documentation section.
Description check ✅ Passed The PR description addresses the summary and reasoning, though it lacks specific testing details and skips non-applicable sections like demo video and bot review checklist.
Linked Issues check ✅ Passed The PR directly addresses issue #2009 by removing the outdated Claude Code hooks section from notifications.md that was no longer relevant after version 0.60.0.
Out of Scope Changes check ✅ Passed The changes are narrowly scoped to removing the outdated documentation section specified in issue #2009; no unrelated modifications are present.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@greptile-apps

greptile-apps Bot commented Mar 24, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

This PR removes the now-obsolete "Claude Code Hooks" section from docs/notifications.md, which previously instructed users to manually add idle_prompt and permission_prompt hook entries to ~/.claude/settings.json. Since v0.60.0 (PR #247), cmux wraps the claude binary automatically and injects these hooks, making the manual configuration both unnecessary and misleading.

  • Removal is correct — the 31-line JSON block is genuinely obsolete for any user on v0.60.0+.
  • One discoverability gap — the document introduction still names "Claude Code" as a supported agent, and the ## Integration Examples section now has no Claude Code entry. A new user searching for Claude Code setup instructions will find nothing. A one-sentence stub explaining that automatic integration requires no action would close this gap.
  • No code changes, no runtime impact, no tests required.

Confidence Score: 5/5

  • Safe to merge — documentation-only removal of a confirmed-obsolete section with no code or runtime impact.
  • The change is a pure docs deletion of content the PR description confirms was superseded in v0.60.0. The only feedback is a non-blocking P2 suggestion to add a discoverability note for Claude Code users; this has zero effect on correctness or safety.
  • No files require special attention.

Important Files Changed

Filename Overview
docs/notifications.md Removes the 31-line "Claude Code Hooks" section that documented now-unnecessary manual ~/.claude/settings.json configuration; the rest of the file is untouched. The only follow-up opportunity is adding a brief note that Claude Code works automatically since v0.60.0 so users landing on this page aren't left without any Claude Code guidance.

Sequence Diagram

sequenceDiagram
    participant U as User
    participant CC as claude (wrapped binary)
    participant cmux as cmux wrapper
    participant N as Notification Panel

    Note over CC,cmux: Automatic since v0.60.0 — no ~/.claude/settings.json config needed
    U->>CC: runs claude command
    CC->>cmux: hooks injected automatically by wrapper
    cmux->>N: cmux notify --title 'Claude Code' --body 'Waiting for input'
    N-->>U: macOS notification shown

    Note over CC,cmux: Pre-0.60.0 (removed section)
    U-->CC: manually add JSON hooks to ~/.claude/settings.json
Loading

Reviews (1): Last reviewed commit: "docs(notifications): remove pre-0.60 Cla..." | Re-trigger Greptile

Comment thread docs/notifications.md
Comment on lines 55 to 57
## Integration Examples

### Claude Code Hooks

Add to `~/.claude/settings.json`:

```json
{
"hooks": {
"Notification": [
{
"matcher": "idle_prompt",
"hooks": [
{
"type": "command",
"command": "command -v cmux &>/dev/null && cmux notify --title 'Claude Code' --body 'Waiting for input' || osascript -e 'display notification \"Waiting for input\" with title \"Claude Code\"'"
}
]
},
{
"matcher": "permission_prompt",
"hooks": [
{
"type": "command",
"command": "command -v cmux &>/dev/null && cmux notify --title 'Claude Code' --subtitle 'Permission' --body 'Approval needed' || osascript -e 'display notification \"Approval needed\" with title \"Claude Code\"'"
}
]
}
]
}
}
```

### OpenAI Codex

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Missing automatic-integration note for Claude Code

The document intro (line 2) still advertises "AI agents like Claude Code" and the ## Integration Examples section now jumps straight to OpenAI Codex with no mention of Claude Code at all. A user arriving here specifically to configure Claude Code notifications will find no guidance and may incorrectly assume manual setup is still needed.

A short note at the top of the section (or a dedicated stub entry) would make the automatic-since-0.60.0 behaviour discoverable:

Suggested change
## Integration Examples
### Claude Code Hooks
Add to `~/.claude/settings.json`:
```json
{
"hooks": {
"Notification": [
{
"matcher": "idle_prompt",
"hooks": [
{
"type": "command",
"command": "command -v cmux &>/dev/null && cmux notify --title 'Claude Code' --body 'Waiting for input' || osascript -e 'display notification \"Waiting for input\" with title \"Claude Code\"'"
}
]
},
{
"matcher": "permission_prompt",
"hooks": [
{
"type": "command",
"command": "command -v cmux &>/dev/null && cmux notify --title 'Claude Code' --subtitle 'Permission' --body 'Approval needed' || osascript -e 'display notification \"Approval needed\" with title \"Claude Code\"'"
}
]
}
]
}
}
```
### OpenAI Codex
## Integration Examples
### Claude Code
Claude Code integration is automatic since v0.60.0 — no manual configuration required. cmux wraps the `claude` command and injects notification hooks for idle and permission prompts automatically.
### OpenAI Codex

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No issues found across 1 file

@lawrencecchen

Copy link
Copy Markdown
Contributor

Thanks for the contribution! This has been addressed by #2053 which was merged.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs (Notifications): Clean up pre-0.60 "Claude Code hooks" section in "Notifications" docs

2 participants