---
slug: "cc-dev-tools"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/lucklyric/cc-dev-tools@main/README.md"
repo: "https://github.com/lucklyric/cc-dev-tools"
source_file: "README.md"
branch: "main"
---
# cc-dev-tools

Claude Code marketplace containing development tools and AI integrations for advanced workflows.

## Overview

This marketplace provides Claude Code plugins for enhanced development capabilities through external AI CLI integrations and automation tools.

## Available Plugins

| Plugin | Description | Type |
|--------|-------------|------|
| [Codex](#codex-plugin) | OpenAI GPT-5.6 series integration for frontier reasoning tasks | Skill |
| [Gemini](#gemini-plugin) | Google Gemini 3.1 Pro AI integration for research and reasoning | Skill |
| [Nano Banana](#nano-banana-plugin) | Standalone image generation via MCP (no Gemini CLI needed) | MCP + Skill |
| [Telegram Notifier](#telegram-notifier-plugin) | Telegram notifications for Claude Code events | Hooks |
| [tmux](#tmux-plugin) | Agent-CLI orchestration in tmux — canonical tmux know-how that codex references | Skill |

---

### Codex Plugin

Frontier AI assistant through OpenAI Codex CLI (GPT-5.6 series) integration.

**Core Features:**
- **GPT-5.6 series**: `gpt-5.6-sol` (frontier, default), `gpt-5.6-terra` (balanced), `gpt-5.6-luna` (fast) — pick model + effort per task
- **Extended effort ladder**: low · medium · high · xhigh · **max** · **ultra** (5.6 adds `max`/`ultra`; default `xhigh`); override via `CC_CODEX_MODEL` / `CC_CODEX_EFFORT`
- **Code Review**: delegate `codex review` over uncommitted changes, a base branch, or a commit
- **Session Continuation**: Resume previous conversations with `codex exec resume --last`
- **Safe Sandbox Defaults**: Read-only by default, workspace-write for code editing
- **Codex Beside Claude**: By default spawns/reuses one codex instance as a **pane in your current tmux window** (visible next to Claude, no separate attach); falls back to one dedicated reusable window (`codex-<claude6>`) when Claude isn't running inside tmux. Supports multi-pane orchestration — detect all your codex panes (`panes`), spawn extra topic-named panes in the current window (`pane --topic`), and drive them independently. Generic tmux orchestration lives in the [tmux plugin](#tmux-plugin), which codex now formally depends on (auto-installed with codex).

**Quick Start:**
```bash
# Install (npm or Homebrew — both are officially recommended)
npm install -g @openai/codex
# or: brew install --cask codex

codex --version  # Requires v0.144.0+ for the GPT-5.6 series
codex login
```

**Usage:**
```
> Use Codex to design a binary search tree in Rust
```

| Info | Value |
|------|-------|
| Path | [`plugins/codex/`](https://github.com/lucklyric/cc-dev-tools/tree/HEAD/plugins/codex/) |
| Version | 3.7.1 |
| Models | GPT-5.6-Sol / Terra / Luna (GPT-5.5 fallback) |

**Full Documentation**: [Codex Plugin README](https://github.com/lucklyric/cc-dev-tools/blob/HEAD/plugins/codex/README.md)

---

### Gemini Plugin

Google Gemini 3.1 Pro AI integration through Gemini CLI for research, reasoning, and web search.

**Core Features:**
- **Gemini 3.1 Pro Default**: Uses `gemini-3.1-pro-preview` for ALL tasks (highest capability)
- **Version-Based Mapping**: User requests like "use 3" automatically map to the latest 3.x model
- **Session Continuation**: Resume previous conversations with `-r latest`
- **Web Search Integration**: Built-in web search for research and documentation lookup

**Quick Start:**
```bash
npm install -g @google/gemini-cli@latest  # Requires v0.33.0+
gemini login
```

**Usage:**
```
> Gemini, explain the observer pattern with examples
```

| Info | Value |
|------|-------|
| Path | [`plugins/gemini/`](https://github.com/lucklyric/cc-dev-tools/tree/HEAD/plugins/gemini/) |
| Version | 2.1.0 |
| Skills | Gemini (reasoning) |
| Models | Gemini 3.1 Pro, 3 Pro, 2.5 Pro/Flash |

**Full Documentation**: [Gemini Plugin README](https://github.com/lucklyric/cc-dev-tools/blob/HEAD/plugins/gemini/README.md)

---

### Nano Banana Plugin

Standalone image generation plugin using the [Nano Banana MCP server](https://github.com/gemini-cli-extensions/nanobanana). Runs directly as an MCP server — no Gemini CLI dependency.

**Core Features:**
- **Direct MCP Integration**: 7 native image tools without CLI overhead
- **Text-to-Image**: Generate batch images with style and variation controls
- **Image Editing**: Modify and restore photos with natural language
- **Icon Generation**: App icons, favicons, UI elements in multiple sizes
- **Diagrams & Patterns**: Technical diagrams, seamless textures, visual stories

**Quick Start:**
```bash
export GEMINI_API_KEY=your_key  # Requires Node.js v18+
```

**Usage:**
```
> Generate 3 variations of a sunset over mountains
> Create an app icon for a coffee shop
> Draw a flowchart for user authentication
```

| Info | Value |
|------|-------|
| Path | [`plugins/nanobanana/`](https://github.com/lucklyric/cc-dev-tools/tree/HEAD/plugins/nanobanana/) |
| Version | 1.4.0 |
| Tools | generate_image, edit_image, restore_image, generate_icon, generate_pattern, generate_story, generate_diagram |
| Commands | /generate, /edit, /restore, /icon, /pattern, /story, /diagram, /nanobanana |

**Full Documentation**: [Nano Banana Plugin README](https://github.com/lucklyric/cc-dev-tools/blob/HEAD/plugins/nanobanana/README.md)

---

### Telegram Notifier Plugin

Receive Telegram notifications when Claude Code completes responses, subagent tasks finish, or system notifications occur.

**Core Features:**
- **Stop Hook**: Notifies when Claude Code completes a response
- **SubagentStop Hook**: Notifies when subagent tasks complete
- **Notification Hook**: Forwards Claude Code system notifications
- **Custom Messages**: Customize notification messages via environment variables
- **Dry-Run Mode**: Test configuration without sending real notifications

**Quick Start:**
```bash
# Set environment variables
export CC_TELEGRAM_BOT_TOKEN="your-bot-token"
export CC_TELEGRAM_CHAT_ID="your-chat-id"
```

**Environment Variables:**

| Variable | Required | Description |
|----------|----------|-------------|
| `CC_TELEGRAM_BOT_TOKEN` | Yes | Bot API token from BotFather |
| `CC_TELEGRAM_CHAT_ID` | Yes | Target chat ID for notifications |
| `CC_TELEGRAM_STOP_MSG` | No | Custom message for Stop events |
| `CC_TELEGRAM_SUBAGENT_MSG` | No | Custom message for SubagentStop events |
| `CC_TELEGRAM_NOTIFY_MSG` | No | Custom message for Notification events |
| `CC_TELEGRAM_DRY_RUN` | No | Set to `true` to log without sending |

| Info | Value |
|------|-------|
| Path | [`plugins/telegram-notifier/`](https://github.com/lucklyric/cc-dev-tools/tree/HEAD/plugins/telegram-notifier/) |
| Version | 0.4.0 |
| Type | Hooks only (no skills or agents) |

**Full Documentation**: [Telegram Notifier README](https://github.com/lucklyric/cc-dev-tools/blob/HEAD/plugins/telegram-notifier/README.md)

---

### tmux Plugin

Canonical, reusable guide for one agent (Claude) to drive and observe *other* interactive agent CLIs inside tmux. This is the single source of generic tmux know-how that the [Codex plugin](#codex-plugin) references instead of re-teaching it.

**Core Features:**
- **Agent Identity & Naming**: Stable per-session identity (`claude6`) with window naming and binding/reuse patterns
- **Session/Window/Pane Model**: How to spawn, find, and target windows for an agent CLI
- **Send & Capture**: Send inline or via tmpfile, two-phase idle detection, incremental capture and delta extraction
- **Sync & Lifecycle**: One-driver discipline, `flock` serialization, spawn/find/kill/cleanup, orphan and dead-window detection
- **Per-CLI Calibration**: Guidance for codex, gemini, aider, and generic REPLs; codex is the reference implementation

**Usage:**
```
> Drive the aider CLI in tmux and capture its output once it goes idle
> Orchestrate an interactive agent CLI inside a reusable tmux window
```

| Info | Value |
|------|-------|
| Path | [`plugins/tmux/`](https://github.com/lucklyric/cc-dev-tools/tree/HEAD/plugins/tmux/) |
| Version | 0.1.0 |
| Skills | tmux (agent-CLI orchestration) |
| Type | Skill only (no hooks or agents) |

**Full Documentation**: [tmux Plugin README](https://github.com/lucklyric/cc-dev-tools/blob/HEAD/plugins/tmux/README.md)

---

## Installation

### Step 1: Add this marketplace
```bash
/marketplace add https://github.com/Lucklyric/cc-dev-tools
```

### Step 2: Install plugins
```bash
# Install Codex plugin
/plugin install codex@cc-dev-tools

# Install Gemini plugin
/plugin install gemini@cc-dev-tools

# Install Telegram Notifier plugin
/plugin install telegram-notifier@cc-dev-tools

# Install tmux plugin
/plugin install tmux@cc-dev-tools
```

### Step 3: Restart Claude Code

## Repository Structure

```
cc-dev-tools/                          # Marketplace root
├── .claude-plugin/
│   └── marketplace.json               # Marketplace metadata
├── README.md                          # This file
├── LICENSE                            # Apache 2.0
└── plugins/
    ├── codex/                         # Codex CLI integration
    │   ├── .claude-plugin/
    │   │   └── plugin.json
    │   ├── README.md
    │   └── skills/codex/
    │       ├── SKILL.md
    │       └── references/
    │
    ├── gemini/                        # Gemini CLI integration
    │   ├── .claude-plugin/
    │   │   └── plugin.json
    │   ├── README.md
    │   └── skills/gemini/              # Reasoning & research skill
    │       ├── SKILL.md
    │       └── references/
    │
    ├── nanobanana/                    # Standalone image generation (MCP)
    │   ├── .claude-plugin/
    │   │   └── plugin.json
    │   ├── .mcp.json                  # MCP server definition
    │   ├── commands/                  # Slash commands (/generate, /edit, etc.)
    │   ├── mcp-server/                # Bundled MCP server (Node.js)
    │   ├── README.md
    │   └── skills/nanobanana/
    │       ├── SKILL.md
    │       └── references/
    │
    ├── telegram-notifier/             # Telegram notifications
    │   ├── .claude-plugin/
    │   │   └── plugin.json
    │   ├── hooks/
    │   │   └── hooks.json             # Stop, SubagentStop, Notification hooks
    │   └── README.md
    │
    └── tmux/                          # Agent-CLI orchestration in tmux
        ├── .claude-plugin/
        │   └── plugin.json
        ├── README.md
        └── skills/tmux/               # Canonical tmux orchestration skill
            ├── SKILL.md
            └── references/
```

## How It Works

**Three-tier hierarchy**: Marketplace → Plugin → Components (Skills/Hooks)

1. You add the **marketplace** (`cc-dev-tools`) from GitHub
2. You install a **plugin** (e.g., `codex`, `gemini`, or `telegram-notifier`)
3. The plugin provides **components**:
   - **Skills**: Invoked by Claude when triggered (codex, gemini, tmux)
   - **Hooks**: Event-driven automation (telegram-notifier)

## Migration from cc-skill-codex

**Repository Renamed**: This repository was renamed from `cc-skill-codex` to `cc-dev-tools` on 2025-11-18.

**For existing clones**, update your remote URL:
```bash
git remote set-url origin git@github.com:Lucklyric/cc-dev-tools.git
```

GitHub automatically redirects the old URL, so existing clones will continue to work.

## Contributing

Contributions welcome! This marketplace follows Claude Code's official plugin structure.

## License

Apache 2.0

## Version

**Marketplace**: 2.31.1

| Plugin | Version |
|--------|---------|
| Codex | 3.7.1 |
| Gemini | 2.1.0 |
| Nano Banana | 1.4.0 |
| Telegram Notifier | 0.4.0 |
| tmux | 0.1.0 |

## Links

- **Repository**: https://github.com/Lucklyric/cc-dev-tools
- **Issues**: https://github.com/Lucklyric/cc-dev-tools/issues
- **Author**: 0xasun