Usar plugins / Crear plugins
Instala un paquete para tus agentes o crea un paquete portable Agent Plugins 1.0 con instrucciones y configuración de herramientas.
Usar plugins
Con Node.js 22 o posterior:
npx universal-agent-plugins add context7El CLI pregunta qué agentes compatibles quieres usar e indica los pasos de activación pendientes. Para examinar y previsualizar primero:
npx universal-agent-plugins info context7
npx universal-agent-plugins add context7 --target codex,cursor --dry-runLa guía de instalación nativa ofrece ejecutables para macOS, Linux y Windows. El gestor nativo no necesita Node.js, aunque cada plugin puede requerir su propio entorno de ejecución.
CLI nativo conserva el ámbito de proyecto explícito y la selección automática de install introducida en 0.1.94. También añade una API local de gestión y extensiones de Pi, Skills y MCP. Para previsualizar una instalación de proyecto:
Para una entrada revisada y compatible del catálogo, la CLI publicada acepta el nombre corto del Directory firmado con ámbito de proyecto explícito cuando el cliente admite todos los componentes obligatorios (por ejemplo, npx universal-agent-plugins add context7 --target codex --scope project --dry-run). También puedes usar un origen Git revisado y fijado a un SHA completo. Sustituye OWNER/REPOSITORY, FULL_COMMIT_SHA y PACKAGE_PATH; si el paquete está en la raíz del repositorio, omite //PACKAGE_PATH.
Plantilla: github:OWNER/REPOSITORY@FULL_COMMIT_SHA//PACKAGE_PATH. El comando siguiente usa un commit histórico real de GitLab; no demuestra que esa revisión siga aprobada en el catálogo. Para una instalación nueva, copia la fuente revisada actual del catálogo.
npx universal-agent-plugins add github:777genius/universal-agent-plugins@2ddbb99dd190c1792b79904f9875e6322bccd243//plugins/gitlab --target codex --scope project \
--project-root /path/to/project --dry-runElige un directorio de proyecto existente. add usa por defecto el ámbito de usuario: selecciona proyecto explícitamente para esta operación. Desde CLI nativo 0.1.94, install sin argumento de origen detecta el proyecto solo si existe un uap.toml regular en el directorio actual exacto; no busca en los superiores. Un ámbito explícito tiene prioridad. Esa selección automática exige 0.1.94 o posterior: comprueba agentplugins version y usa el instalador nativo para obtener la versión verificada. Los canales de npm y Homebrew pueden actualizarse más tarde; el ejemplo Git fijado a un SHA completo con ámbito Project funciona desde 0.1.93; los nombres cortos de Directory en Project requieren la CLI estable actual. Revisa el plan antes de omitir --dry-run. La detección nativa, la confianza, la autenticación y las llamadas MCP correctas siguen siendo independientes de escribir los archivos del paquete.
Recorrido completo de instalación · Compatibilidad de clientes y límites de las pruebas
Restaura unas dependencias guardadas
Consulta lo registrado en el entorno de usuario seleccionado:
npx universal-agent-plugins deps statusPara un par uap.toml/uap.lock guardado, exporta desde una carpeta de intercambio:
npx universal-agent-plugins deps exportCopia la carpeta a otra máquina, instala los clientes de destino y ejecuta allí:
npx universal-agent-plugins deps import
npx universal-agent-plugins install --locked --scope userSolo se transfieren el acuerdo y el bloqueo validados. Perfiles, ajustes, credenciales, recibos y datos del plugin se mantienen aparte. La instalación sigue necesitando los orígenes exactos o paquetes verificados en caché. Para un proyecto, guarda ambos archivos en control de versiones y restaura con install --locked --scope project explícito. Consulta mantenimiento y restauración para conocer recuperación y transferencia.
Crear plugins
Un paquete estándar comienza con plugin.json en la raíz y puede incluir skills/<name>/SKILL.md, mcp.json o ambos. Puedes escribir esos archivos a mano y validar el paquete con el instalador publicado:
npx universal-agent-plugins validate ./my-plugin
npx universal-agent-plugins add ./my-plugin --target codex --dry-runEstos ejemplos suponen que ./my-plugin ya contiene un paquete completo. La guía de creación explica un paquete Skill manual y las herramientas que generan estructuras iniciales desde el código fuente.
Disponibilidad de creación: el instalador actual npm o nativo no incluye agentplugins author. El código fuente actual implementa generación inicial, comprobaciones estáticas, pruebas MCP explícitas, ciclos de desarrollo, instalación de dependencias y mantenimiento JSON. Usa la preparación desde el código fuente para esos comandos. Las pruebas de publicaciones anteriores corresponden a sus propias versiones; no prometen lo mismo para el instalador actual.
La validación estática no demuestra ejecución, OAuth ni activación. Los transportes MCP admitidos también dependen del cliente: por ejemplo, Codex no admite MCP SSE declarado. Explica los requisitos del paquete y las comprobaciones pendientes en el README.