acplugin

Convert Claude Code plugins to Codex CLI, OpenCode, Cursor, and Google Antigravity formats.

Install

npm install -g @disdjj/acplugin

Or use directly with npx:

npx @disdjj/acplugin convert .

Quick Start

# Interactive wizard — just run acplugin!
acplugin

# Convert current project
acplugin convert .

# Convert from GitHub
acplugin convert anthropics/claude-code --all --to cursor

# Scan resources without converting
acplugin scan anthropics/claude-code

Features

Converts Skills, Instructions, MCP configs, Agents, Commands, and Hooks
4 target platforms: Codex CLI, OpenCode, Cursor, Google Antigravity
Full subagent conversion with proper format for each platform
Automatic model mapping (Claude → GPT-5.4 / Gemini 3 Pro)
Supports Claude Code Plugin marketplace format (multi-plugin repos)
Interactive TUI with checkbox selection for plugins and platforms
Direct GitHub repo support — no need to clone first
Smart detection: auto-detects local projects, plugins, and marketplace repos

Supported Conversions

| Resource | Codex CLI | OpenCode | Cursor | Antigravity | | ---------------- | ------------------------- | ------------------------- | --------------------- | ----------------------- | | Skills | .agents/skills/ | .opencode/skills/ | .cursor/skills/ | .agent/skills/ | | Instructions | AGENTS.md | AGENTS.md | .cursor/rules/*.mdc | GEMINI.md | | MCP Servers | .codex/config.toml | opencode.json | .cursor/mcp.json | .gemini/settings.json | | Agents | .codex/agents/*.toml | .opencode/agents/*.md | .cursor/agents/*.md | .gemini/agents/*.md | | Commands | Converted to Skills | .opencode/commands/ | .cursor/commands/ | Converted to Skills | | Hooks | Documented in AGENTS.md | Documented in AGENTS.md | Warnings only | Warnings only |

Model Mapping

| Claude Code | → Codex | → Antigravity | | ----------------- | --------- | ---------------- | | sonnet / opus | gpt-5.4 | gemini-3-pro | | haiku | gpt-5.4 | gemini-3-flash | | (not specified) | gpt-5.4 | gemini-3-pro |

OpenCode and Cursor keep the original model value.

CLI Reference

`acplugin scan [source]`

Scan and list convertible resources.

acplugin scan .                              # Current directory
acplugin scan ./my-project                   # Local path
acplugin scan anthropics/claude-code         # GitHub repo
acplugin scan https://github.com/owner/repo  # Full GitHub URL
acplugin scan owner/repo --path plugins/foo  # Sub-path in repo

`acplugin convert [source]`

Convert Claude Code plugins to target platform formats.

acplugin convert .                           # Interactive: select platforms
acplugin convert . --to cursor               # Specify platform
acplugin convert . --to codex,antigravity    # Multiple platforms
acplugin convert anthropics/claude-code      # From GitHub, interactive
acplugin convert anthropics/claude-code --all  # All plugins, no prompt
acplugin convert . -o ./output               # Custom output directory
acplugin convert . --dry-run                 # Preview without writing

Options:

| Option | Description | | ---------------------- | -------------------------------------------------------------------------------- | | -t, --to <platforms> | Target platforms (comma-separated: codex, opencode, cursor, antigravity) | | -o, --output <path> | Output directory | | -a, --all | Convert all plugins without interactive selection | | -p, --path <subpath> | Sub-path within repository | | --dry-run | Show what would be generated without writing |

Examples

Convert a local project

cd my-project
acplugin convert . --to cursor,antigravity

Convert from GitHub Plugin Marketplace

# Interactive: browse and select plugins
acplugin convert anthropics/claude-code

# Convert all plugins to all platforms
acplugin convert anthropics/claude-code --all -o ./converted

Scan a repo to see available resources

$ acplugin scan anthropics/claude-code

Claude Code Plugin Marketplace
✔ Found 13 plugin(s) with resources

1. agent-sdk-dev [development] — 3 resource(s)
2. code-review [productivity] — 1 resource(s)
3. commit-commands [productivity] — 3 resource(s)
...

Private repos

Set GITHUB_TOKEN to access private repositories:

export GITHUB_TOKEN=ghp_xxx
acplugin convert my-org/private-plugins --all --to codex

How It Works

Scan — Detects Claude Code resources: .claude/ project structure, .claude-plugin/ plugin format, or marketplace repos
Select — Interactive TUI lets you pick which plugins and platforms to target
Convert — Transforms each resource to the target platform's format, with model mapping and field adaptation
Report — Shows what was generated, with warnings for resources that couldn't be fully converted

Claude-specific features (like context: fork, agent: Explore) are preserved as HTML comments in the output files for reference.

License

MIT

Acplugin

Install / Use

README