awesome-agent

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:

1. Codex should work. run codex -V to check. (0.79.0+)
2. Gemini should work. run gemini -v to check. (0.23.0+)
3. jq should work. run jq -V to check. (1.8.1+). brew install jq will install jq.
4. 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:

1. 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

2. 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:

1. 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
2. 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.
3. 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:

1. Clone the repository:

   git clone https://github.com/caidish/cAI-tools.git ~/cAI-tools
   

2. Add the marketplace:

   claude plugin marketplace add ~/cAI-tools