OpenCode Plugin
gzb1128/opencode-plugin
Gestor de plugins Claude Code para OpenCode com zero atrito
Ver no GitHubCLI em Go que traz compatibilidade com o ecossistema de plugins do Claude Code para OpenCode. Instala, gerencia e sincroniza plugins com suporte total a marketplaces, mantendo cache local e vinculando skills aos agentes.
Instalação
npx convez-ai gzb1128/opencode-plugin1 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
Casos de uso
- Instalar plugins de marketplaces Claude Code em ambientes OpenCode
- Gerenciar múltiplos plugins e suas dependências localmente
- Sincronizar skills de plugins para agentes sem configuração manual
Veredito

Ferramenta sólida para operacionalizar o ecossistema de plugins do Claude em fluxos OpenCode. Preenche um gap real de compatibilidade entre marketplaces, embora dependa da maturidade do próprio ecossistema OpenCode.
README
A tradução para o português deste README ainda está na fila.
opencode-plugin
Claude Code plugin marketplace compatibility layer for OpenCode — install and manage plugins from Claude Code-compatible marketplaces with zero friction.
opencode-plugin is a CLI for installing marketplace plugins into an
OpenCode-style agent setup.
It keeps plugin files in a local cache and links plugin skills into
~/.agents/skills.
Note: This project is not built by, endorsed by, or affiliated with the OpenCode team. It is an independent, community-built tool that works with the OpenCode ecosystem.
What It Does
- Adds plugin marketplaces from GitHub shorthand, Git URLs, local marketplace
directories, or local
marketplace.jsonfiles. - Searches, installs, updates, and removes plugins from added marketplaces.
- Caches installed plugin files under
~/.opencode-plugin-cli/cache. - Links files from a plugin's
skills/directory into~/.agents/skills. - Preserves the plugin cache so other plugin assets remain locally available.
- Does not install or modify OpenCode MCP configuration.
Install
Download a Release Binary
Download the archive for your OS and CPU architecture from:
https://github.com/gzb1128/opencode-plugin/releases
Extract the archive, move opencode-plugin into a directory on your PATH, and
verify the install:
opencode-plugin --version
macOS Gatekeeper
On macOS, downloaded binaries are tagged with a quarantine attribute by the
browser. When you first run opencode-plugin, you may see:
"opencode-plugin" cannot be opened because Apple cannot check it for malicious software.
This happens because release binaries are built on CI and are not signed with an Apple Developer ID. Run the following command in Terminal to remove the quarantine attribute and re-sign the binary locally:
xattr -cr /usr/local/bin/opencode-plugin && codesign --force --sign - /usr/local/bin/opencode-plugin
If the binary is in a different location, replace /usr/local/bin/opencode-plugin
with the actual path.
Alternatively, right-click the binary in Finder and choose Open, then click Open in the security dialog. You only need to do this once.
Build from Source
Build and install with make:
make build
make install
make install copies the binary to /usr/local/bin/. If that directory is not
writable, use local-install to install to ~/.local/bin instead (no sudo
needed):
make build
make local-install
Make sure ~/.local/bin is on your PATH. You can add it with:
export PATH="$HOME/.local/bin:$PATH"
Building from source avoids the macOS Gatekeeper quarantine issue described above, since the binary is built locally and not downloaded through a browser.
To remove a locally-installed binary:
make uninstall-local
You can also build from source directly:
git clone https://github.com/gzb1128/opencode-plugin.git
cd opencode-plugin
go build -o bin/opencode-plugin .
Quick Start
opencode-plugin market add anthropics/claude-plugins-official
opencode-plugin plugin search
opencode-plugin plugin install code-simplifier
opencode-plugin plugin list
Marketplaces
Add a marketplace:
opencode-plugin market add owner/repo
opencode-plugin market add git@github.com:owner/repo.git
opencode-plugin market add https://github.com/owner/repo.git
opencode-plugin market add ./path/to/marketplace
opencode-plugin market add ./path/to/marketplace.json
Manage configured marketplaces:
opencode-plugin market list
opencode-plugin market update
opencode-plugin market update my-market
opencode-plugin market remove my-market
Plugins
opencode-plugin plugin search git
opencode-plugin plugin search --market my-market
opencode-plugin plugin install my-plugin
opencode-plugin plugin install my-plugin@my-market
opencode-plugin plugin install my-plugin --version 1.0.0
opencode-plugin plugin info my-local-plugin
opencode-plugin plugin list
opencode-plugin plugin update
opencode-plugin plugin update my-plugin
opencode-plugin plugin remove my-plugin
Runtime Files
~/.opencode-plugin-cli/
├── known_marketplaces.json
├── installed_plugins.json
├── markets/
└── cache/
└── <market-name>/
└── <plugin-name>/
└── <version>/
├── .claude-plugin/
├── skills/
└── ...
~/.agents/
└── skills/
└── <skill-name> -> ~/.opencode-plugin-cli/cache/.../skills/<skill-name>
Only skills/ are linked today. Other plugin files stay in the plugin cache.
Version Resolution
For plugins bundled in a marketplace, the selected version is resolved in this order:
--version.claude-plugin/plugin.jsonversion- Git commit SHA, shortened to 12 characters
latest
For remote plugin sources, an explicit source SHA is used first. If no SHA is
defined, --version is used when provided; otherwise the version is latest.
Development
- Usage guide: docs/USAGE.md
- Architecture notes: docs/design/ARCHITECTURE.md
- Development notes: docs/develop/develop.md
Run tests with:
make test
make test runs go test ./..., including e2e tests that clone the official
marketplace from GitHub.
License
MIT