cAI-tools
A collection of Claude Code plugins containing custom agents, skills, commands, and notification hooks.
Tested with macOS Claude Code v2.0.76+.
The plugin is made conservative in context usage by keeping concise and precise writing.
Needed tools:
- Codex should work. run
codex -V to check. (0.79.0+)
- Gemini should work. run
gemini -v to check. (0.23.0+)
- jq should work. run
jq -V to check. (1.8.1+).
brew install jq will install jq.
- Mathpix API for paper review OCR. Get credentials from Mathpix Console. Save
MATHPIX_APP_ID and MATHPIX_APP_KEY to your environment. This is optional, but strongly encouraged for paper review skill.
Plugins
| Plugin | Description |
|---|
| awesome-agent | Collection of useful prompted subagents for code review, API docs, QA, and more. Variant from: awesome-claude-code-subagents |
| AI-skill | Skills for interacting with other AI tools - Codex, Gemini CLI, and collaboration fixes. Codex is a variant from Skill Codex |
| pushover | Pushover notification hooks - get notified when tasks complete or permissions are needed |
| mac | macOS integration - speak, send iMessages, emails, manage calendar, and display stickies |
Example:
- AI-skill:
Use codex and gemini-cli to review uncommitted changes.
Check this with codex
AI-skill:collob-fix Fix the bug showing here as ### Bug 3
- mac:
after you finish, use mac to say "All done" and a brief summary of what you did.
Use imessage to send me (my email address/phone number) a message "Task complete" with the summary.
Can you add this to my stikies?
Use mac to generate today's calendar schedule with the information on my stikies.
Known Issues:
- Pushover: Claude Code does not have a hook that fires specifically when a user rejects a permission prompt. The system relies on subsequent activity (like
Stop or UserPromptSubmit) to cancel escalations(a daemon that send notification by timing). I believe this is a limitation of Claude Code's current hook system, and should be addressed in future versions. We now use a simple session-level tracking to manage escalations. The Pushover is now very annoying because of the 60s, but it is a good push for me. You can change it here escalation service
- mac: The
ical.sh script reads all calendars but only writes to a calendar named "Agent". If your calendar contains sensitive information, be cautious when using this skill.
- All email/message/calendar features depend on the respective macOS apps being properly configured with accounts. First run of osascript may prompt for permissions.
Installation
Add the Marketplace
claude plugin marketplace add /path/to/cAI-tools
Install Plugins
You can enter claude interface and use /plugin to navigate to my marketplace and install each plugin.
# Install all plugins
claude plugin install awesome-agent@cAI-tools
claude plugin install AI-skill@cAI-tools
claude plugin install pushover@cAI-tools
claude plugin install mac@cAI-tools
Pushover Setup (for pushover plugin)
Run the one-time setup to store your Pushover credentials in macOS Keychain:
./setup-service.sh
Get your credentials from pushover.net.
Alternative: Let an LLM Agent do it
Paste this into a fresh Claude Code session:
Install and configure by following the instructions here https://raw.githubusercontent.com/caidish/cAI-tools/refs/heads/main/README.md
For LLM Agents
Instructions for LLM Agents (click to expand)
Instructions for LLM Agents
If you're an LLM Agent helping set up cAI-tools, Welcome! You'll help your user install a collection of useful Claude Code plugins. Greet them with: Your dish of cAI is served!
Follow these steps:
-
Clone the repository:
git clone https://github.com/caidish/cAI-tools.git ~/cAI-tools
-
Add the marketplace:
claude plugin marketplace add ~/cAI-tools