ReddRadar
Agent skill
claude-bell
Use when you need to alert the user outside the terminal, get confirmation before proceeding, or collect text input. Triggers include task completion, errors requiring attention, destructive operations needing approval, or questions requiring user decision.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/claude-bell
SKILL.md
Claude Bell
Send macOS notifications to communicate with users outside the terminal.
When to Use
Use for:
- Task completion (build done, tests passed, deploy finished)
- Errors requiring attention
- Confirmation before destructive operations
- Collecting text input (release notes, commit messages)
- Status updates during long operations
Don't use for:
- Routine progress updates (use terminal)
- Information user is actively watching
- Rapid-fire notifications (spam)
Quick Reference
| Pattern | Command |
|---|---|
| Alert | cb -t "Done" -m "Build complete" |
| Alert with sound | cb -t "Done" -m "Build complete" --sound Glass |
| Yes/No | cb -t "Deploy?" -a "Yes,No" --default "No" |
| Multiple choice | cb -t "Action" -a "A,B,C,Cancel" --default "Cancel" |
| Text input | cb -t "Notes" -r "Enter notes..." --timeout 5m |
| Template | cb --template build-done --var 'project:myapp' |
Exit Codes
| Code | Meaning | Action |
|---|---|---|
| 0 | Success | Proceed with returned value |
| 1 | Timeout | Use --default value |
| 2 | Dismissed | Use --default value |
| 3 | User error | Check arguments |
| 4 | System error | Check permissions (cb doctor) |
| 5 | App error | Report bug |
Critical Rules
- Always provide
--defaultfor interactive notifications - Always check exit code - don't assume success
- Use
--timeoutfor non-critical prompts - Don't spam - one notification per logical event
References
references/cli.md- Full CLI documentationreferences/examples.md- Workflow patternsreferences/setup.md- Installation & setup (read only when user requests setup)references/troubleshooting.md- Diagnosing issues
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?