kiro-cc-plugins

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

kiro-cc-plugins

★ 9 Open GitHub ↗

Install Claude Code plugins into Kiro

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">kiro-cc-plugins</h1>

Install <a href="https://code.claude.com/docs/en/plugins">Claude Code plugins</a> into <a href="https://kiro.dev">Kiro</a>.

<a href="README.zh-CN.md">中文 README</a> · Blog: <a href="https://mp.weixin.qq.com/s/4hbZ4E-ZwZQOfLRkiiaJ9Q">让 Kiro 能力倍增，使用 kiro-cc-plugins 一键接入 Claude Code 插件生态</a>

<a href="https://mp.weixin.qq.com/s/4hbZ4E-ZwZQOfLRkiiaJ9Q">
 <img src="docs/blog-qr.png" width="160" alt="Scan to read the blog post" />
 </a>
 
 WeChat: scan to read

Supports marketplace repos (like the [official Anthropic marketplace](https://github.com/anthropics/claude-plugins-official)) and standalone plugin/skill repos.

## Demo

https://github.com/user-attachments/assets/72ae01e3-42fb-4091-8265-ea5346f4f30c

## Install

### CLI

```bash
# One-line install (macOS / Linux)
curl -fsSL https://raw.githubusercontent.com/vokako/kiro-cc-plugins/main/install.sh | bash

# Or build from source
cargo install --git https://github.com/vokako/kiro-cc-plugins kiro-cc-plugins
```

No system `git`, Python, or other runtime required — single self-contained binary.

### Desktop App

Download `.dmg` (macOS) or `.exe` (Windows) from the [releases page](https://github.com/vokako/kiro-cc-plugins/releases).

#### macOS: "App is damaged" or "cannot be opened"

The `.dmg` is not code-signed, so macOS Gatekeeper blocks it by default. After dragging the app to `/Applications`, run this once to remove the quarantine flag:

```bash
xattr -d com.apple.quarantine /Applications/KiroCCPlugins.app
```

Then open the app normally. Alternatively, right-click the app → **Open** → **Open** in the warning dialog (only works for some macOS versions).

If you prefer to build from source instead, see [Architecture](#architecture) below.

## Desktop App Guide

### Step 1: Add Sources

Go to the **Sources** tab and paste a git repository URL (e.g. `https://github.com/anthropics/claude-plugins-official`). Click **ADD** to clone the marketplace. You can add multiple sources — each source card shows its name, URL, and latest commit. Use **↻ UPDATE ALL** to pull the latest from all sources.

### Step 2: Browse & Install Plugins

Click a source card to jump to the **Plugins** tab filtered by that source, or switch to the Plugins tab directly. Use the search bar and source filter to find plugins. Click a plugin to see its details and components. Hit **⬡ INSTALL** to install it. Each component card shows an **ON/OFF** toggle to enable or disable individual skills, agents, or MCP servers.

### Step 3: Manage Installed Plugins

Switch to the **Installed** tab to see all installed plugins as cards. Each card shows its components with enable/disable status — click a component tag to toggle it. Use **✓✓** / **✗✗** to bulk enable or disable all components. Click a card to jump to its detail view in the Plugins tab. Use **✕** to uninstall.

## CLI Quick Start

```bash
# Add the official Claude Code marketplace
kiro-cc-plugins source add https://github.com/anthropics/claude-plugins-official

# Add the Anthropic skills repo
kiro-cc-plugins source add https://github.com/anthropics/skills.git

# Show overview of sources and installed plugins
kiro-cc-plugins status

# Browse all available plugins
kiro-cc-plugins list

# Show plugin details
kiro-cc-plugins list feature-dev

# Install a plugin (auto-detects which source)
kiro-cc-plugins add feature-dev

# Install only specific component types
kiro-cc-plugins add plugin-dev --only skill

# Install from any git URL directly
kiro-cc-plugins add --git https://github.com/user/my-cc-plugin

# Update installed plugins (git pull + re-convert)
kiro-cc-plugins update --all

# Delete a plugin
kiro-cc-plugins delete feature-dev
```

After installing agents, run them with:

```bash
kiro-cli chat --agent feature-dev
```

### Private repositories

Public repos work out of the box. For private repos, credentials are resolved in this order: `GH_TOKEN`/`GITHUB_TOKEN` env, git credential helper (osxkeychain/wincred/…), SSH agent, `~/.ssh/id_*` keys. Anything libgit2 can't handle (FIDO2 keys, custom SSH config, enterprise auth) falls through to the system `git` binary — if `git clone <url>` works in your terminal, this tool can clone it too.

Easiest setup for GitHub:

```bash
export GH_TOKEN=$(gh auth token)
```

## Commands

| Command | Description |
|---|---|
| `status` | Show sources and installed plugins overview |
| `source add <url>` | Clone a marketplace or plugin repo |
| `source list` | List registered sources |
| `source update [name]` | Git pull sources (or all) |
| `source remove <name>` | Remove a source (refuses if plugins installed) |
| `source remove <name> --force` | Remove source and uninstall its plugins |
| `source remove --all --force` | Wipe all sources and plugins |
| `list` | List all plugins across all sources |
| `list <plugin>` | Show plugin details, install status, and run commands |
| `list --installed` | Show installed plugins with enable/disable status |
| `list --skills` | List all skills across sources |
| `list --agents` | List all agents across sources |
| `add <name>` | Install a plugin (auto-detects source) |
| `add --all` | Install all locally available plugins |
| `add --only skill,agent` | Install only specific component types |
| `add --scope workspace` | Install to `.kiro/` instead of `~/.kiro/` |
| `add --git <url>` | Install directly from a git URL |
| `update <name> / --all` | Git pull source and re-convert |
| `update --only skill` | Re-convert only specific component types |
| `delete <name> / --all` | Remove installed plugins (alias: `remove`) |
| `delete -y` | Skip confirmation prompt |
| `enable <plugin>` | Enable all components of a plugin |
| `enable <plugin> --component <name>` | Enable a specific component |
| `enable <plugin> --only skill` | Enable only skills |
| `disable <plugin>` | Disable all components of a plugin |
| `disable <plugin> --component <name>` | Disable a specific component |
| `export` | Export all config to stdout |
| `export -o <file>` | Export all config to a file |
| `import <file>` | Import config (sources, plugins, enable states) |

## Conversion Mapping

| Claude Code | Kiro | Format |
|---|---|---|
| `skills/*/SKILL.md` | `~/.kiro/skills/{source}--{plugin}--{skill}/` | Direct copy |
| `commands/*.md` | `~/.kiro/agents/{source}--{plugin}--{name}.json` | Prompt → agent JSON |
| `agents/*.md` | `~/.kiro/agents/{source}--{plugin}--{name}.json` | Prompt → agent JSON, tools mapped |
| `.mcp.json` | `~/.kiro/settings/mcp.json` (key `cc-{plugin}-{server}`) | Merged into Kiro MCP settings |

## Unsupported Claude Code Features

The following Claude Code plugin features have no Kiro equivalent and are **skipped** during conversion:

| Feature | Plugins Using It | Why Skipped |
|---|---|---|
| **Hooks** (`hooks/`, `hooks.json`) | hookify, ralph-loop, security-guidance, explanatory-output-style, learning-output-style | Kiro has no hook system (PreToolUse, PostToolUse, Stop, etc.) |
| **Hook handlers** (`hooks-handlers/`) | explanatory-output-style, learning-output-style | Shell/Python scripts triggered by hooks |
| **LSP servers** (`lspServers` in marketplace) | clangd-lsp, gopls-lsp, pyright-lsp, rust-analyzer-lsp, typescript-lsp, + 7 more | Kiro does not support custom LSP server configuration |
| **Runtime code** (`core/`, `utils/`, `matchers/`, `scripts/`) | hookify | Python/shell runtime dependencies for hooks |
| **`strict` mode** | Some marketplace entries | No equivalent enforcement in Kiro |

Skills, agents, commands, and MCP servers are fully converted. If a plugin only contains hooks or LSP configs, it will install with 0 components.

## Enable / Disable

Components can be individually enabled or disabled without uninstalling:

- **Skills**: moved to `~/.kiro/cc-plugins/disabled-skills/` when disabled
- **Agents/Commands**: moved to `~/.kiro/cc-plugins/disabled-agents/` when disabled
- **MCP servers**: `"disabled": true` flag set in `~/.kiro/settings/mcp.json`

The desktop app shows toggle buttons on each component card.

## Status Icons

| Icon | Meaning |
|---|---|
| ✓ (green) | Installed & enabled |
| ✗ | Disabled |
| ○ (green) | Available locally |
| ○ (yellow) | Fetchable (external, auto-cloned on `add`) |

## Data Storage

```
~/.kiro/cc-plugins/
├── config.json          # Registered sources
├── registry.json        # Installed plugin tracking
├── cache/               # Cloned git repos
├── disabled-skills/     # Parked disabled skills
└── disabled-agents/     # Parked disabled agents
```

## Architecture

Cargo workspace with three crates:

- `crates/core/` — Core library (source, scanner, converter, registry, JSON API)
- `crates/cli/` — CLI binary (`kiro-cc-plugins`)
- `gui/` — Tauri + Svelte desktop app (uses `crates/core` as in-process SDK)

```bash
# Build everything
cargo build --release

# Run CLI
cargo run -p kiro-cc-plugins -- status

# Run tests
cargo test
cargo test -p kiro_cc_core --test e2e -- --ignored  # requires network

# Build desktop app
cd gui && npm install && npm run tauri build
```

kiro-cc-plugins

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README