cc-dev-tools

内容来源：README.md（说明文档） · 原始地址 · 查看安装指南

原始内容

# 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

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	OpenAI GPT-5.6 series integration for frontier reasoning tasks	Skill
Gemini	Google Gemini 3.1 Pro AI integration for research and reasoning	Skill
Nano Banana	Standalone image generation via MCP (no Gemini CLI needed)	MCP + Skill
Telegram Notifier	Telegram notifications for Claude Code events	Hooks
tmux	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, which codex now formally depends on (auto-installed with codex).

Quick Start:

# 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/`
Version	3.7.1
Models	GPT-5.6-Sol / Terra / Luna (GPT-5.5 fallback)

Full Documentation: Codex Plugin README

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:

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/`
Version	2.1.0
Skills	Gemini (reasoning)
Models	Gemini 3.1 Pro, 3 Pro, 2.5 Pro/Flash

Full Documentation: Gemini Plugin README

Nano Banana Plugin

Standalone image generation plugin using the Nano Banana MCP server. 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:

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

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:

# 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/`
Version	0.4.0
Type	Hooks only (no skills or agents)

Full Documentation: Telegram Notifier README

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 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/`
Version	0.1.0
Skills	tmux (agent-CLI orchestration)
Type	Skill only (no hooks or agents)

Full Documentation: tmux Plugin README

Installation

Step 1: Add this marketplace

/marketplace add https://github.com/Lucklyric/cc-dev-tools

Step 2: Install plugins

# 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)

You add the marketplace (cc-dev-tools) from GitHub
You install a plugin (e.g., codex, gemini, or telegram-notifier)
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:

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