README.md

acplugin-action

中文文档

GitHub Action that automatically converts Claude Code plugins to Codex CLI, OpenCode, Cursor, and Google Antigravity formats.

Usage

Add to your workflow (.github/workflows/acplugin.yml):

name: Convert Plugins
on:
  push:
    branches: [main]
    paths:
      - '.claude/**'
      - '.claude-plugin/**'
      - 'plugins/**'
      - 'CLAUDE.md'
      - '.mcp.json'

jobs:
  convert:
    runs-on: ubuntu-latest
    permissions:
      contents: write
    steps:
      - uses: actions/checkout@v4
      - uses: TokenRollAI/acplugin-action@v1
        with:
          platforms: codex,opencode,cursor,antigravity

That's it! When you push changes to Claude Code plugins, the action will automatically convert them and commit the results back to your repo.

Inputs

Input	Description	Default
platforms	Target platforms (comma-separated)	codex,opencode,cursor,antigravity
source	Source directory to scan	.
output	Output directory	.
all	Convert all plugins (for marketplace repos)	true
commit	Auto-commit generated files	true
commit-message	Commit message	chore: auto-convert Claude Code plugins via acplugin

Outputs

Output	Description
files-changed	Number of files generated
platforms-converted	Platforms that were converted to

Examples

Convert only to Cursor

- uses: TokenRollAI/acplugin-action@v1
  with:
    platforms: cursor

Custom output directory

- uses: TokenRollAI/acplugin-action@v1
  with:
    output: ./converted
    commit-message: 'build: update converted plugins'

Dry run (no commit)

- uses: TokenRollAI/acplugin-action@v1
  with:
    commit: 'false'

Use in a plugin marketplace repo

- uses: TokenRollAI/acplugin-action@v1
  with:
    all: 'true'
    platforms: codex,cursor,antigravity

How It Works

1. Installs @disdjj/acplugin globally
2. Runs acplugin convert with your configuration
3. Commits generated files back to the repo (if commit: true)

License

MIT