convez.ai
Skill
cheneeheng

claude-code-plugin-toggler

cheneeheng/claude-code-plugin-toggler

Ver no GitHub
InicialPluginScore · de 0 a 100

A developer tool for managing Claude Code skill plugins.

Instalação

$npx convez-ai cheneeheng/claude-code-plugin-toggler

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 4 meses
Versão
v0.9.1
Issues abertas
5
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

claude-code-plugin-toggler

A developer tool for managing Claude Code skill plugins. Toggle plugins on/off per-project from a browser UI or directly inside VSCode. Browse and install new plugins from known marketplaces without leaving the UI.

User guides: HTML version · VSCode extension

How it works

Reads installed plugins from ~/.claude/plugins/installed_plugins.json (global, managed externally) and writes enabled/disabled state to .claude/settings.local.json in the current project root. Claude Code picks up the updated settings on the next session.

~/.claude/plugins/installed_plugins.json   (global — source of installed plugins)
~/.claude/plugins/known_marketplaces.json  (global — marketplace registry)
        │
        ├──▶ html/server.py  ←HTTP/SSE→  html/index.html
        └──▶ vscode-extension/extension.js  ←Webview→  vscode-extension/webview/panel.html
                    │
                    ▼
        <project>/.claude/settings.local.json   (per-project — enabled state)

Both surfaces use the same read/merge/write logic (implemented independently in Python and Node.js). server.py is stdlib-only. The VSCode extension has no npm runtime dependencies.

Quick start

HTML version — run from the root of the project you want to manage:

cd /your/project
python3 /path/to/claude-code-plugin-toggler/html/server.py        # port 7779
python3 /path/to/claude-code-plugin-toggler/html/server.py 8080   # custom port

Convenience scripts in html/: start.sh (Linux/macOS), start.ps1 / start.bat (Windows).

VSCode extension — dev mode: open vscode-extension/ and press F5. To package:

cd vscode-extension && vsce package   # produces .vsix; prepackage hook syncs CSS

Data format

~/.claude/plugins/installed_plugins.json

{ "plugins": { "frontend-design@anthropic": {}, "docx@anthropic": {} } }

~/.claude/plugins/known_marketplaces.json

{
  "ceh-plugins": {
    "installLocation": "C:\\Users\\Chen\\.claude\\plugins\\marketplaces\\ceh-plugins",
    "lastUpdated": "2026-05-14T14:18:52.841Z"
  }
}

.claude/settings.local.json (written by this tool)

{ "enabledPlugins": { "frontend-design@anthropic": true, "docx@anthropic": false } }

Plugin ID format: name@marketplace.

Skills and agents are read from the plugin's install path at load time:

<installPath>/skills/<skill-dir>/SKILL.md     # YAML front matter: name, description
<installPath>/agents/<agent>.md               # YAML front matter: name, description

Marketplace plugin listings are read from:

<installLocation>/.claude-plugin/marketplace.json

If installed_plugins.json is missing, server.py falls back to MOCK_PLUGINS and sets "mock": true in the API response.

CSS sync

html/styles.css is canonical. vscode-extension/webview/styles.css is generated — do not edit it directly.

make sync-css           # macOS / Linux
.\scripts\sync-css.ps1  # Windows

vsce package runs this automatically via the prepackage npm script.

Requirements

  • HTML version: Python 3.13+ (stdlib only)
  • VSCode extension: VSCode 1.80+
  • Install feature: claude CLI on PATH
  • CSS sync: make (macOS/Linux) or PowerShell (Windows)

Troubleshooting

[WinError 10053] in server output (Windows only): benign — the browser closed a connection before the server finished reading it. Suppressed at the handle_error level; no action needed. See HTML user guide for details.

Ver o original no GitHub

Bom para

Relacionados