mac

A collection of Claude Code plugins containing custom agents, skills, 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.

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

Example:

1. AI-skill:

Use codex and gemini-cli to review uncommitted changes.

Check this with codex

Use the AI-skill:collab-fix skill to fix the bug showing here as ### Bug 3

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

<img width="330" height="326" alt="macTools" src="https://github.com/user-attachments/assets/674ac8d8-d62a-4e5a-bd6c-584991634c36" /> <img width="206" height="46" alt="Pushover" src="https://github.com/user-attachments/assets/e3965610-31f8-4aec-a36c-c94c2cf0aef2" /> <img width="202" height="117" alt="Sticker" src="https://github.com/user-attachments/assets/d76ca525-757a-4768-835d-803cb5c7eca6" />

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

<details> <summary>Instructions for LLM Agents (click to expand)</summary>

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:

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

1. Add the marketplace:

``bash claude plugin marketplace add ~/cAI-tools ``

1. Ask user which plugins to install:

- awesome-agent - Specialized subagents for code review, QA, API docs, etc. - AI-skill - Integration with Codex and Gemini CLI - pushover - Push notifications when tasks complete or need approval (requires Pushover account - ask user if they want this) - mac - macOS integration (iMessage, email, calendar, stickies, TTS)

1. Install selected plugins:

``bash 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 ``

1. For pushover plugin only: Run the setup script to configure Pushover credentials:

``bash ~/cAI-tools/setup-service.sh `` User needs credentials from pushover.net.

1. Optional but recommended: Add bash timeout settings to ~/.claude/settings.json:

``json { "env": { "BASH_DEFAULT_TIMEOUT_MS": "600000", "BASH_MAX_TIMEOUT_MS": "3600000" } } ``

1. Verify installation: Run claude plugin list to confirm plugins are installed.

Tell the user installation is complete and give a brief overview of what they can now do!

</details>

Plugin Details

awesome-agent

Specialized task agents for various workflows:

• •api-documenter - API documentation generation
• •code-reviewer - Code review and suggestions
• •llm-architect - LLM system design
• •mcp-developer - MCP server development
• •performance-engineer - Performance optimization
• •qa-expert - Quality assurance
• •qcodes-specialist - QCodes instrumentation
• •quantum-device-specialist - Quantum device control
• •test-automator - Test automation
• •tooling-engineer - Developer tooling
• •typescript-pro - TypeScript expertise

AI-skill

Skills for AI tool integration:

pushover

Push notifications via Pushover with automatic escalation system.

Skill: notification - Send on-demand push notifications to your phone

Hooks: Automatic permission escalation - get notified when Claude is waiting for approval (60s normal, 1hr emergency)

See pushover/README.md for architecture details and configuration.

mac

macOS native app integration:

Uninstallation

claude plugin uninstall awesome-agent@cAI-tools
claude plugin uninstall AI-skill@cAI-tools
claude plugin uninstall pushover@cAI-tools
claude plugin uninstall mac@cAI-tools

Bash Timeout Settings

For best experience with long-running tasks:

Add to ~/.claude/settings.json to extend bash timeouts:

{
  "env": {
    "BASH_DEFAULT_TIMEOUT_MS": "600000",
    "BASH_MAX_TIMEOUT_MS": "3600000"
  }
}

Version Control

A TUI tool for managing plugin versions across marketplace.json, plugin.json, and Claude CLI.

Setup for human

Install gum for the best TUI experience (optional):

brew install gum

Interactive TUI mode:

./tools/plugin-version.sh

AI Usage

Examples:

# CLI commands
./tools/plugin-version.sh status              # View version status
./tools/plugin-version.sh update              # Update plugins in Claude
./tools/plugin-version.sh update mac          # Update specific plugin
./tools/plugin-version.sh bump mac patch      # Bump version (patch/minor/major)
./tools/plugin-version.sh bump-all minor      # Bump all plugins
./tools/plugin-version.sh set mac 2.0.0       # Set specific version
./tools/plugin-version.sh sync                # Sync plugin.json to marketplace.json

AI Workflow

If changes are made to a plugin

1. Run ./tools/plugin-version.sh bump <plugin> patch to increment version
2. Run ./tools/plugin-version.sh status to see status and update Claude