{"meta":{"title":"referência de plugin da CLI GitHub Copilot","intro":"Encontre comandos e detalhes de configuração para plug-ins da CLI.","product":"GitHub Copilot","breadcrumbs":[{"href":"/pt/copilot","title":"GitHub Copilot"},{"href":"/pt/copilot/reference","title":"Referência"},{"href":"/pt/copilot/reference/copilot-cli-reference","title":"CLI do Copilot referência"},{"href":"/pt/copilot/reference/copilot-cli-reference/cli-plugin-reference","title":"Referência do plugin CLI"}],"documentType":"article"},"body":"# referência de plugin da CLI GitHub Copilot\n\nEncontre comandos e detalhes de configuração para plug-ins da CLI.\n\n> \\[!NOTE]\n> Você pode encontrar ajuda para usar plug-ins entrando `copilot plugin [SUBCOMMAND] --help` no terminal.\n\n## Comandos da CLI\n\nVocê pode usar os seguintes comandos no terminal para gerenciar plug-ins para CLI do Copilot.\n\n| Command | Descrição |\n| ---------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |\n| `copilot plugin install SPECIFICATION` | Instale um plug-in. Consulte [Especificação do plugin para `install` o comando](#plugin-specification-for-install-command) abaixo. |\n| `copilot plugin uninstall NAME` | Remover um plug-in |\n| `copilot plugin list` | Listar plug-ins instalados |\n| `copilot plugin update NAME` | Atualize um plug-in nomeado. Use `--all` para atualizar todos os plug-ins instalados ao mesmo tempo. |\n| `copilot plugin enable NAME` | Habilitar um plug-in desabilitado anteriormente |\n| `copilot plugin disable NAME` | Desabilitar um plug-in sem desinstalá-lo |\n| `copilot plugin marketplace add SPECIFICATION` | Registrar um marketplace |\n| `copilot plugin marketplace list` | Listar marketplaces registrados |\n| `copilot plugin marketplace browse NAME` | Navegue pelos plugins do marketplace |\n| `copilot plugin marketplace remove NAME` | Cancelar o registro de um marketplace |\n\n### Especificação do plug-in para `install` comando\n\n| Formato | Exemplo | Descrição |\n| ---------------------------- | ---------------------------- | ------------------------------------ |\n| Marketplace | `plugin@marketplace` | Plug-in de um marketplace registrado |\n| GitHub | `OWNER/REPO` | Raiz de um GitHub repositório |\n| GitHub Subdir | `OWNER/REPO:PATH/TO/PLUGIN` | Subdiretório em um repositório |\n| Git URL | `https://github.com/o/r.git` | Qualquer URL do Git |\n| Caminho local | | |\n| `./my-plugin` ou `/abs/path` | Diretório local | |\n\n## `plugin.json`\n\nTodos os plug-ins consistem em um diretório de plug-in contendo, no mínimo, um arquivo de manifesto chamado `plugin.json` localizado na raiz do diretório do plug-in. Consulte [Criando um plug-in para CLI do GitHub Copilot](/pt/copilot/how-tos/copilot-cli/customize-copilot/plugins-creating).\n\n### Campo obrigatório\n\n| Campo | Tipo | Descrição |\n| ------ | ------ | -------------------------------------------------------------------------------- |\n| `name` | cadeia | Nome do plugin Kebab-case (apenas letras, números e hífens). Máximo de 64 chars. |\n\n### Campos de metadados opcionais\n\n| Campo | Tipo | Descrição |\n| ----------------------------------------------------------- | ----------------------- | ---------------------------------------------- |\n| `description` | cadeia | Breve descrição. Máximo de 1024 caracteres. |\n| `version` | cadeia | Versão semântica (por exemplo, `1.0.0`). |\n| `author` | objeto | |\n| `name` (obrigatório), `email` (opcional), `url` (opcional). | | |\n| `homepage` | cadeia | URL da página inicial do plugin. |\n| `repository` | cadeia | URL do repositório de origem. |\n| `license` | cadeia | Identificador de licença (por exemplo, `MIT`). |\n| `keywords` | cadeia de caracteres\\[] | Pesquisar palavras-chave. |\n| `category` | cadeia | Categoria de plug-in. |\n| `tags` | cadeia de caracteres\\[] | Etiquetas adicionais. |\n\n### Campos de caminho do componente\n\nElas indicam à CLI onde encontrar os componentes do seu plug-in. Todos são opcionais. A CLI usa convenções padrão se omitidas.\n\n| Campo | Tipo | Default | Descrição |\n| ------------ | ----------------------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------ |\n| `agents` | cadeia de caracteres \\| cadeia de caracteres\\[] | `agents/` | Caminhos para diretórios de agente (`.agent.md` arquivos). |\n| `skills` | cadeia de caracteres \\| cadeia de caracteres\\[] | `skills/` | Caminhos para diretórios de habilidades (`SKILL.md` arquivos). |\n| `commands` | cadeia de caracteres \\| cadeia de caracteres\\[] | — | Caminhos para diretórios de comando. |\n| `hooks` | objeto string \\| | — | Caminho para um arquivo de configuração de ganchos ou um objeto de ganchos embutido. |\n| `mcpServers` | objeto string \\| | — | Caminho para um arquivo de configuração MCP (por exemplo, `.mcp.json`) ou definições de servidor integradas. |\n| `lspServers` | objeto string \\| | — | Caminho para um arquivo de configuração LSP ou definições de servidor em linha. |\n\n### Arquivo de exemplo `plugin.json`\n\n```json copy\n{\n \"name\": \"my-dev-tools\",\n \"description\": \"React development utilities\",\n \"version\": \"1.2.0\",\n \"author\": {\n \"name\": \"Jane Doe\",\n \"email\": \"jane@example.com\"\n },\n \"license\": \"MIT\",\n \"keywords\": [\"react\", \"frontend\"],\n \"agents\": \"agents/\",\n \"skills\": [\"skills/\", \"extra-skills/\"],\n \"hooks\": \"hooks.json\",\n \"mcpServers\": \".mcp.json\"\n}\n```\n\n## `marketplace.json`\n\nVocê pode criar um marketplace de plug-ins, que as pessoas podem usar para descobrir e instalar seus plug-ins, criando um `marketplace.json` arquivo e salvando-o no `.github/plugin/` diretório do repositório. Você também pode armazenar o `marketplace.json` arquivo em seu sistema de arquivos local. Por exemplo, salvar o arquivo como `/PATH/TO/my-marketplace/.github/plugin/marketplace.json` permite adicioná-lo à CLI usando o seguinte comando:\n\n```shell\ncopilot plugin marketplace add /PATH/TO/my-marketplace\n```\n\n> \\[!NOTE]\n> O CLI do Copilot também procura o arquivo `marketplace.json` no diretório `.claude-plugin/`.\n\nPara obter mais informações, consulte [Criando um marketplace de plugin para CLI do GitHub Copilot](/pt/copilot/how-tos/copilot-cli/customize-copilot/plugins-marketplace).\n\n### Arquivo de exemplo `marketplace.json`\n\n```json copy\n{\n \"name\": \"my-marketplace\",\n \"owner\": {\n \"name\": \"Your Organization\",\n \"email\": \"plugins@example.com\"\n },\n \"metadata\": {\n \"description\": \"Curated plugins for our team\",\n \"version\": \"1.0.0\"\n },\n \"plugins\": [\n {\n \"name\": \"frontend-design\",\n \"description\": \"Create a professional-looking GUI ...\",\n \"version\": \"2.1.0\",\n \"source\": \"./plugins/frontend-design\"\n },\n {\n \"name\": \"security-checks\",\n \"description\": \"Check for potential security vulnerabilities ...\",\n \"version\": \"1.3.0\",\n \"source\": \"./plugins/security-checks\"\n }\n ]\n}\n```\n\n> \\[!NOTE]\n> O valor do `source` campo para cada plug-in é o caminho para o diretório do plug-in, em relação à raiz do repositório. Não é necessário usar `./` no início do caminho. Por exemplo, `\"./plugins/plugin-name\"` e `\"plugins/plugin-name\"` resolvem para o mesmo diretório.\n\n### Campos `marketplace.json`\n\n#### Campos de nível superior\n\n| Campo | Tipo | Obrigatório | Descrição |\n| ---------------------------------------------------------------- | ------ | ----------- | -------------------------------------------------------- |\n| `name` | cadeia | Sim | Nome do mercado de kebabs. Máximo de 64 chars. |\n| `owner` | objeto | Sim | |\n| `{ name, email? }` — informações do proprietário do marketplace. | | | |\n| `plugins` | matriz | Sim | Lista de entradas de plug-in (consulte a tabela abaixo). |\n| `metadata` | objeto | No | `{ description?, version?, pluginRoot? }` |\n\n#### Campos de entrada de plug-in (objetos dentro da `plugins` matriz)\n\n| Campo | Tipo | Obrigatório | Descrição |\n| ------------- | ----------------------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| `name` | cadeia | Sim | Nome do plugin Kebab-case. Máximo de 64 chars. |\n| `source` | objeto string \\| | Sim | Onde buscar o plug-in (caminho relativo GitHub ou URL). |\n| `description` | cadeia | No | Descrição do plug-in. Máximo de 1024 caracteres. |\n| `version` | cadeia | No | Versão do plug-in. |\n| `author` | objeto | No | `{ name, email?, url? }` |\n| `homepage` | cadeia | No | URL da página inicial do plugin. |\n| `repository` | cadeia | No | URL do repositório de origem. |\n| `license` | cadeia | No | Identificador de licença. |\n| `keywords` | cadeia de caracteres\\[] | No | Pesquisar palavras-chave. |\n| `category` | cadeia | No | Categoria de plug-in. |\n| `tags` | cadeia de caracteres\\[] | No | Etiquetas adicionais. |\n| `commands` | cadeia de caracteres \\| cadeia de caracteres\\[] | No | Caminhos para diretórios de comando. |\n| `agents` | cadeia de caracteres \\| cadeia de caracteres\\[] | No | Caminhos para diretórios de agente. |\n| `skills` | cadeia de caracteres \\| cadeia de caracteres\\[] | No | Caminhos para diretórios de habilidades. |\n| `hooks` | objeto string \\| | No | Caminho para a configuração de hooks ou objeto de hooks inline. |\n| `mcpServers` | objeto string \\| | No | Caminho para a configuração do MCP ou definições do servidor em linha. |\n| `lspServers` | objeto string \\| | No | Caminho para a configuração do LSP ou definições do servidor em linha. |\n| `strict` | boolean | No | Quando `true` (o padrão), os plug-ins devem estar em conformidade com o esquema completo e as regras de validação. Quando `false` a validação relaxada é usada, permite mais flexibilidade, especialmente para instalações diretas ou plugins legados. |\n\n## Locais de arquivos\n\n| Item | Caminho |\n| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| Plug-ins instalados | |\n| `~/.copilot/installed-plugins/MARKETPLACE/PLUGIN-NAME` (instalado por meio de um marketplace) e `~/.copilot/installed-plugins/_direct/SOURCE-ID/` (instalado diretamente) | |\n| Cache do Marketplace | Diretório de cache de plataforma: `~/.cache/copilot/marketplaces/` (Linux) `~/Library/Caches/copilot/marketplaces/` (macOS). Substituível por `COPILOT_CACHE_HOME`. |\n| Manifesto do Plugin | |\n| `.plugin/plugin.json`, `plugin.json`ou `.github/plugin/plugin.json``.claude-plugin/plugin.json` (verificado nesta ordem) | |\n| Manifesto do Marketplace | |\n| `marketplace.json`, `.plugin/marketplace.json`ou `.github/plugin/marketplace.json``.claude-plugin/marketplace.json` (verificado nesta ordem) | |\n| Agentes | |\n| `agents/` (padrão, substituível no manifesto) | |\n| Habilidades | |\n| `skills/` (padrão, substituível no manifesto) | |\n| Configuração de ganchos | |\n| `hooks.json` ou `hooks/hooks.json` | |\n| Configuração do MCP | |\n| `.mcp.json`, `.github/mcp.json` | |\n| Configuração de LSP | |\n| `lsp.json` ou `.github/lsp.json` | |\n| Dados de plug-in | |\n| `${COPILOT_PLUGIN_DATA}` (também disponível como `${CLAUDE_PLUGIN_DATA}`). Aponta para um diretório persistente, com permissão de gravação, exclusivo para cada plug-in instalado. Use isso para dados de runtime específicos do plug-in em vez de caminhos dentro do diretório de cache de plug-ins instalados. | |\n\n## Ordem e precedência de carregamento\n\nSe você instalar vários plug-ins, é possível que alguns agentes personalizados, habilidades, servidores MCP ou ferramentas fornecidas por meio de servidores MCP tenham nomes duplicados. Nessa situação, a CLI determina qual componente usar com base em uma ordem de precedência.\n\n* **Agentes e habilidades** use a precedência do primeiro encontrado.\n\n Se você tiver um agente personalizado no nível do projeto ou uma habilidade cujo nome ou ID sejam iguais a os de um plug-in que você instalar, o agente ou habilidade do plug-in será ignorado sem aviso. O plug-in não pode substituir configurações pessoais ou no nível do projeto. Os agentes personalizados são desduplicados usando seu ID, que é derivado de seu nome de arquivo (por exemplo, se o arquivo for nomeado `reviewer.agent.md`, a ID do agente será `reviewer`). As habilidades são desduplicadas pelo campo do nome dentro do arquivo `SKILL.md`.\n\n* **Os servidores MCP** usam a precedência \"último a vencer\".\n\n Se você instalar um plug-in que define um servidor MCP com o mesmo nome de servidor que um servidor MCP já instalado, a definição do plug-in terá precedência. Você pode usar a opção `--additional-mcp-config` de linha de comando para substituir uma configuração de servidor MCP com o mesmo nome, instalado usando um plug-in.\n\n* **Ferramentas e agentes internos** estão sempre presentes e não podem ser substituídos por componentes definidos pelo usuário.\n\nO diagrama a seguir ilustra as regras de ordem e precedência de carregamento.\n\n```text\n┌──────────────────────────────────────────────────────────────────┐\n│ BUILT-IN - HARDCODED, ALWAYS PRESENT │\n│ • tools: bash, view, apply_patch, glob, rg, task, ... │\n│ • agents: explore, task, code-review, general-purpose, research │\n└────────────────────────┬─────────────────────────────────────────┘\n │\n ┌──────────────────────▼──────────────────────────────────────────────┐\n │ CUSTOM AGENTS - FIRST LOADED IS USED (dedup by ID) │\n │ 1. ~/.copilot/agents/ (user, .github convention) │\n │ 2. /.github/agents/ (project) │\n │ 3. /.github/agents/ (inherited, monorepo) │\n │ 4. /.claude/agents/ (project) │\n │ 5. /.claude/agents/ (inherited, monorepo) │\n │ 6. PLUGIN: agents/ dirs (plugin, by install order) │\n │ 7. Remote org/enterprise agents (remote, via API) │\n └──────────────────────┬──────────────────────────────────────────────┘\n │\n ┌──────────────────────▼──────────────────────────────────────────────┐\n │ AGENT SKILLS - FIRST LOADED IS USED (dedup by name) │\n │ 1. /.github/skills/ (project) │\n │ 2. /.agents/skills/ (project) │\n │ 3. /.claude/skills/ (project) │\n │ 4. /.github/skills/ etc. (inherited) │\n │ 5. ~/.copilot/skills/ (personal-copilot) │\n │ 6. ~/.agents/skills/ (personal-agents) │\n │ 7. PLUGIN: skills/ dirs (plugin) │\n │ 8. COPILOT_SKILLS_DIRS env + config (custom) │\n │ --- then commands (.claude/commands/), skills override commands ---│\n └──────────────────────┬──────────────────────────────────────────────┘\n │\n ┌──────────────────────▼──────────────────────────────────────────────┐\n │ MCP SERVERS - LAST LOADED IS USED (dedup by server name) │\n │ 1. ~/.copilot/mcp-config.json (lowest priority) │\n │ 2. PLUGIN: MCP configs (plugins) │\n │ 3. --additional-mcp-config flag (highest priority) │\n └─────────────────────────────────────────────────────────────────────┘\n```\n\n## Leitura adicional\n\n* [CLI do GitHub Copilot](/pt/copilot/how-tos/copilot-cli)\n* [referência de comando da CLI GitHub Copilot](/pt/copilot/reference/copilot-cli-reference/cli-command-reference)\n* [referência programática do GitHub Copilot CLI](/pt/copilot/reference/copilot-cli-reference/cli-programmatic-reference)"}