Crea tu CLI

Puedes crear tu propia herramienta de línea de comandos para cualquier servicio o API, y rápido, con nuestra plantilla y tu agente de IA. ¿Usas un CRM, un gestor de tareas o una app de notas que WireCat aún no admite? Añádelo tú.

Esta página muestra lo que hace falta, lo que obtienes y por dónde empezar. Las guías siguientes te acompañan en cada parte.

Dos formas de usarlaCopy Anchor Link

Las dos empiezan desde la misma plantilla y tienen la misma base. La única diferencia es hasta dónde conectas tu herramienta.

• Una herramienta independiente. Quieres una herramienta de línea de comandos rápida para un servicio, y nada más. La plantilla te da la base desde el primer día: los datos del servicio guardados en tu ordenador, búsqueda rápida en ellos, memoria para lo que aprende tu agente, un servidor para agentes de IA e inicio de sesión seguro. No necesitas ninguna otra herramienta WireCat.
• Parte de WireCat. También usas WireCat para chats, correo o reuniones y quieres una sola búsqueda sobre todo. Entonces conecta tu herramienta con las demás: lo que guarda queda junto a todo lo demás y una sola pregunta lo encuentra. Hacen falta unos pasos más, descritos en Añadir una fuente.

Puedes empezar con la primera y conectar tu herramienta más tarde.

Cómo construirla, en breveCopy Anchor Link

1. Empieza desde la plantilla. Un comando crea una herramienta que ya funciona, con todo preparado. No empiezas desde una carpeta vacía.
2. Dile a tu agente de IA qué servicio conectar. La plantilla trae instrucciones para el agente. Te hace unas preguntas sencillas sobre el servicio —qué guarda, cómo se inicia sesión— y luego escribe el código.
3. Haz una prueba con tu cuenta. Ejecuta la herramienta, mira lo que encontró y pide al agente que arregle lo que falte.
4. Compártela, si quieres. Las comprobaciones incluidas te dicen cuándo la herramienta está lista para publicarla para otras personas.

No necesitas saber cómo funciona WireCat por dentro para empezar. Las guías de abajo explican cada parte cuando la necesites.

Qué le da WireCat a tu herramientaCopy Anchor Link

• Tus datos en tu ordenador, con búsqueda rápida. Lo que guarda tu herramienta queda en un archivo local. La búsqueda encuentra palabras en cualquier forma en inglés, ruso y español, y por significado si la activas.
• Memoria para tu agente. Tu agente puede guardar lo que aprendió —un resumen, una preferencia— y encontrarlo después.
• Una sola búsqueda en todas tus herramientas, si la conectas: lo que guarda queda junto a los mensajes, el correo, las reuniones y los documentos de las demás herramientas.
• Trabajo con agentes de IA. Cada comando de tu herramienta está listo para un agente, y tú decides qué puede cambiar.
• Tus cuentas no se mezclan. Siempre indicas qué cuenta usa un comando, así nada va a la cuenta equivocada.
• Inicio de sesión y contraseñas a salvo. Las claves se quedan en el llavero de tu ordenador y nunca aparecen en la salida.
• Comprobaciones que la mantienen funcionando. La plantilla trae las mismas comprobaciones que ejecuta toda herramienta WireCat, para que la tuya siga funcionando mientras WireCat crece.

Qué necesitasCopy Anchor Link

• Una cuenta en el servicio y una forma de que los programas lleguen a él. La mayoría de los servicios te dan una clave de API en sus ajustes o dejan que una app inicie sesión por ti. Un enlace a la documentación para desarrolladores del servicio ayuda mucho a tu agente.
• Un agente de IA para programar que pueda ejecutar comandos: Claude Code, Codex, Cursor, Gemini CLI u otro parecido.
• Node.js, pnpm y git en tu ordenador.

Empieza desde la plantillaCopy Anchor Link

cli-template es donde empieza toda herramienta nueva. Este comando hace unas preguntas cortas sobre el servicio y crea una herramienta llamada acme en la carpeta acme-cli:

npx @wirecat/cli-template new acme-cli --command acme --package @example/acme-cli --owner example

Comprueba que la nueva herramienta se ejecuta:

cd acme-cli && pnpm install && pnpm build
node dist/bin/acme.js personal doctor

personal es el perfil: un nombre para una de tus cuentas. Ahora abre la carpeta acme-cli con tu agente de IA.

Qué pasa despuésCopy Anchor Link

1. Dile a tu agente lo que quieres. Nombra el servicio, dale el enlace a la documentación para desarrolladores y di qué quieres hacer. Por ejemplo: «Conecta acme a la API de Acme CRM. La documentación está en https://example.com/api. Quiero ver mis acuerdos y encontrar uno por su nombre».
2. Responde a sus preguntas. El agente pregunta cómo se inicia sesión, qué guarda el servicio y qué no debe guardarse nunca. Bastan respuestas cortas.
3. Prueba cada comando con tu propia cuenta. El agente construye los comandos uno a uno, por ejemplo uno que lista tus acuerdos. Ejecútalos y dile al agente qué está mal o qué falta.
4. Haz que se pueda buscar. Pide al agente que guarde en WireCat lo que devuelve el servicio, para que la búsqueda y tus agentes lo encuentren junto a tus chats y tu correo. Añadir una fuente explica cómo.
5. Compártela, si quieres. Cuando pasen las comprobaciones incluidas, publica la herramienta en npm y otras personas la instalarán como cualquier herramienta WireCat.

Si te atascasCopy Anchor Link

• Ejecuta node dist/bin/acme.js personal doctor en la carpeta de la herramienta. Comprueba la instalación, los ajustes y los perfiles.
• Pide a tu agente que vuelva a leer las instrucciones de la plantilla. Cubren los problemas habituales.
• Abre una incidencia en cli-template para una pregunta o un error. No incluyas claves, contraseñas ni datos privados.

Aparece en wirecat.devCopy Anchor Link

Una herramienta fuera de WireCatLabs puede aparecer aquí en el grupo «Herramientas de la comunidad». Abre un pull request a cli-docs que la añada a tools.json con "community": true. Sus páginas se copian entonces desde su repositorio en una etiqueta de versión revisada, como las nuestras. La lista de revisión dice qué comprobamos. Una herramienta de la comunidad publica en su propio ámbito de npm: @wirecat y el nombre «WireCat» siguen siendo nuestros.

Recibe las mejoras de la plantillaCopy Anchor Link

La plantilla sigue mejorando. En tu herramienta, con el árbol de trabajo de git limpio, ejecuta:

npx @wirecat/cli-template upgrade

Para cada archivo de la plantilla que cambió desde tu versión, pregunta qué hacer: apply une el cambio con tu archivo, replace toma el archivo de la plantilla, skip conserva el tuyo y diff muestra antes el cambio. Un conflicto deja las marcas habituales de git; resuelve el conflicto y vuelve a ejecutar upgrade. Los archivos que la plantilla solo puso una vez, como tu código y tus páginas, nunca se tocan. --dry-run lista lo que cambiaría y no escribe nada.

Detalles de la plantillaCopy Anchor Link

Para cuando tú o tu agente necesitéis las opciones exactas.

Las siete preguntasCopy Anchor Link

Cada respuesta, salvo los idiomas, es una opción de una lista corta, y también admite other:<tu respuesta>. Sin terminal, por ejemplo en un script o en la shell de un agente, pásalas como opciones. Entonces una respuesta que falta es un error que lista las opciones; no se adivina nada.

La misma herramienta, creada sin ninguna pregunta:

npx @wirecat/cli-template new acme-cli --command acme --package @example/acme-cli --owner example \
  --category notes --content-lang en --sign-in token --api official-docs --filters time,text \
  --never-store tokens --untrusted messages,links

Aprende de una herramienta parecidaCopy Anchor Link

La plantilla no trae código de ejemplo. Tu agente aprende de la herramienta WireCat más cercana a la tuya, elegida por la primera respuesta:

Por ahora, la búsqueda muestra los registros de tu herramienta como mensajes. Cuando cli-core pueda registrar un tipo de fuente nuevo, tu herramienta podrá registrar el suyo.

Cuatro pasos que hace una personaCopy Anchor Link

new los muestra al final. El último solo se aplica a las herramientas de la organización WireCatLabs.

1. Crea el repositorio y protege su rama main, como dice la lista para un CLI nuevo.
2. Configura en npm la publicación de confianza para tu paquete, con release.yml, y añade los secretos que necesite.
3. Elige para las comprobaciones mensuales un día del mes que no use ningún otro de tus repositorios. El .github/workflows/monthly.yml de la plantilla trae un valor provisional que CI rechaza hasta que lo cambies.
4. Solo herramientas de WireCatLabs: añade la herramienta a los grupos de comparación de cli-base, a la lista de herramientas WireCat de cli-core y al tools.json de este sitio.

Una herramienta fuera de WireCatLabs guarda en su lugar su propio archivo de grupos y ejecuta cli-dev audit --groups <file>, así se compara con nuestras herramientas sin un pull request a cli-base.

Adónde ir despuésCopy Anchor Link

1. Conceptos en cinco minutos: cómo guarda WireCat registros de muchas fuentes.
2. Añadir una fuente: guarda los datos de tu servicio para que la búsqueda y los agentes los usen.
3. Guardar tus propios datos: dónde guarda tu herramienta lo que solo ella necesita.
4. Iniciar sesión en un servicio: claves, el llavero y las cuentas.
5. Cumplir los estándares y mantenerse al día: comprobaciones, versiones y actualizaciones.