Saltar al contenido

Usar plugins ​

Universal Agent Plugins instala paquetes estándar para los agentes de IA que elijas. Un paquete puede contener Skills, configuración de servidores MCP o ambos componentes. Puedes instalarlo para tu cuenta o mantener separadas las dependencias de un proyecto.

Obtén el CLI ​

Con Node.js 22 o posterior, ejecuta directamente el envoltorio npm:

bash
npx universal-agent-plugins search docs

Para usarlo con frecuencia, instálalo globalmente:

bash
npm install -g universal-agent-plugins
agentplugins version

También puedes usar Homebrew:

bash
brew install 777genius/agentplugins/agentplugins

La guía de instalación nativa incluye instrucciones para macOS, Linux y Windows. El gestor nativo no necesita Node.js, aunque cada plugin puede requerir su propio entorno de ejecución. Los ejemplos de este recorrido usan agentplugins; npx universal-agent-plugins ejecuta los mismos comandos de instalación.

Sigue el recorrido de instalación ​

  1. Busca y examina un paquete. Comprueba su procedencia y sus requisitos.
  2. Previsualiza los agentes y el ámbito previstos con --dry-run.
  3. Aplica la instalación revisada y sigue sus instrucciones de activación.
  4. Mantén el estado instalado: consulta, actualiza, repara o elimina paquetes.
  5. Cuando lo necesites, restaura unas dependencias compartidas desde uap.toml y uap.lock.

CLI nativo es el instalador nativo actual. Añade una API local de gestión y extensiones nativas de Pi en los ámbitos de usuario y de proyecto elegible. Consulta la gestión local y la compatibilidad con Pi. Los canales de los gestores de paquetes pueden actualizarse más tarde: comprueba agentplugins version. El instalador nativo ofrece la versión actual verificada.

El ámbito de proyecto explícito está disponible desde 0.1.93. La mayoría de los comandos usa por defecto el ámbito de usuario. Desde 0.1.94, agentplugins install sin argumento de origen ni ámbito explícito selecciona el proyecto si hay un uap.toml regular en el directorio actual exacto; no busca en directorios superiores. Selecciona --scope project para las operaciones de mantenimiento de un proyecto. Los componentes admitidos y la activación dependen del cliente.

Interpreta cada resultado ​

La instalación puede dejar pendientes una recarga, la confianza en el proyecto, la activación manual o un paso OAuth. El resultado Prepared indica que aún quedan pasos en el cliente. Lee el resultado de cada destino; la operación completa no demuestra por sí sola que el plugin funcione durante la ejecución. Consulta la compatibilidad de clientes para conocer el alcance de las observaciones nativas y sus versiones.

Si vas a crear un paquete ​

Empieza por Crear plugins. Lo que se entrega al instalador es un directorio con plugin.json en la raíz y sus componentes. El usuario que instala el paquete no necesita ejecutar las herramientas de creación compiladas desde el código fuente.

ComandoFunción
agentplugins validate ./my-pluginLeer y validar un paquete local para instalarlo.
agentplugins doctorDiagnosticar el estado gestionado por el instalador.
agentplugins author validate ./my-pluginComprobar la conformidad y preparación del paquete en una compilación con creación habilitada.
agentplugins author doctor ./my-pluginExaminar las pruebas del proyecto y de sus herramientas en esa compilación.

La versión actual del instalador npm o nativo no incluye agentplugins author.

Documentación pública para autores de plugins e integradores.