cAI-tools

KO | EN

gitlite — search

#javascript #python #java #ruby #game #android #ios #qt #php #education #c-sharp #c-plus-plus

★ 52 Open GitHub ↗

No description available.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# cAI-tools
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.
4. Mathpix API for paper review OCR. Get credentials from [Mathpix Console](https://console.mathpix.com/). 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](https://github.com/VoltAgent/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](https://github.com/skills-directory/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**: 
```bash
Use codex and gemini-cli to review uncommitted changes.
```
```bash
Check this with codex
```
```bash
Use the AI-skill:collab-fix skill to fix the bug showing here as ### Bug 3
```

2. **mac**: 
```bash 
after you finish, use mac to say "All done" and a brief summary of what you did.
``` 
```bash 
Use imessage to send me (my email address/phone number) a message "Task complete" with the summary.
```
```bash
Can you add this to my stikies?
```

```bash
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](plugins/pushover/scripts/service/escalation_service.py)
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

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

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

```bash
./setup-service.sh
```

Get your credentials from [pushover.net](https://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
   ```

2. **Add the marketplace:**
   ```bash
   claude plugin marketplace add ~/cAI-tools
   ```

3. **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)

4. **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
   ```

5. **For pushover plugin only:** Run the setup script to configure Pushover credentials:
   ```bash
   ~/cAI-tools/setup-service.sh
   ```
   User needs credentials from [pushover.net](https://pushover.net/).

6. **Optional but recommended:** Add bash timeout settings to `~/.claude/settings.json`:
   ```json
   {
     "env": {
       "BASH_DEFAULT_TIMEOUT_MS": "600000",
       "BASH_MAX_TIMEOUT_MS": "3600000"
     }
   }
   ```

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

| Skill | Description |
|-------|-------------|
| codex | OpenAI Codex CLI integration (default model: `gpt-5.5`) |
| gemini-cli | Google Gemini CLI integration |
| collab-fix | Collaborative multi-agent fix workflow (codex + gemini-cli + subagent) |
| TDD-debug | Test-Driven Development debug workflow with multi-agent collab-fix |

### 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](plugins/pushover/README.md) for architecture details and configuration.

### mac

macOS native app integration:

| Feature | Command | Description |
|---------|---------|-------------|
| Text-to-Speech | `say` | Speak messages aloud |
| iMessage | `imessage.sh` | Send iMessages |
| Email | `imail.sh` | Send emails via Mail.app |
| Calendar | `ical.sh` | List/add events (reads all, writes to "Agent" calendar) |
| Stickies | `iStickies.sh` | Read and write notes with markdown support |

## Uninstallation

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

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

| Setting | Value | Description |
|---------|-------|-------------|
| `BASH_DEFAULT_TIMEOUT_MS` | 600000 | Default timeout: 10 min |
| `BASH_MAX_TIMEOUT_MS` | 3600000 | Max timeout: 1 hour |

## Version Control

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

### Setup for human

Install [gum](https://github.com/charmbracelet/gum) for the best TUI experience (optional):

```bash
brew install gum
```

Interactive TUI mode:
```bash
./tools/plugin-version.sh
```

### AI Usage
Examples:
```bash
# 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

cAI-tools

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README