# Crea tu CLI (/es/docs/build-create-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 usarla [#dos-formas-de-usarla]

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](/llms.mdx/docs/es/build-add-source/content.md).

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

## Cómo construirla, en breve [#cómo-construirla-en-breve]

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 herramienta [#qué-le-da-wirecat-a-tu-herramienta]

* **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é necesitas [#qué-necesitas]

* **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 plantilla [#empieza-desde-la-plantilla]

[cli-template](https://github.com/WireCatLabs/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`:

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

Comprueba que la nueva herramienta se ejecuta:

```sh
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és [#qué-pasa-después]

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](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](/llms.mdx/docs/es/build-add-source/content.md) 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 atascas [#si-te-atascas]

* 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](https://github.com/WireCatLabs/cli-template/issues) para una pregunta o un
  error. No incluyas claves, contraseñas ni datos privados.

## Aparece en wirecat.dev [#aparece-en-wirecatdev]

Una herramienta fuera de WireCatLabs puede aparecer aquí en el grupo «Herramientas de la comunidad». Abre un pull
request a [cli-docs](https://github.com/WireCatLabs/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](https://github.com/WireCatLabs/cli-docs/blob/main/docs/REVIEWING.md#community-tools) 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 plantilla [#recibe-las-mejoras-de-la-plantilla]

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

```sh
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 plantilla [#detalles-de-la-plantilla]

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

### Las siete preguntas [#las-siete-preguntas]

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.

| Pregunta | Opción | Valores (varios, separados por comas) |
| --- | --- | --- |
| ¿Qué tipo de herramienta es? | `--category` | `messenger`, `mail`, `notes`, `files`, `calendar`, `meetings` |
| ¿En qué idiomas está el contenido? | `--content-lang` | códigos de idioma, se admiten varios: `en,ru` |
| ¿Cómo inicia sesión una persona? | `--sign-in` | `oauth`, `token`, `session` (código por teléfono, QR), `none` |
| ¿Qué ofrece el servicio para construir? | `--api` | `official-client`, `official-docs`, `unofficial` |
| ¿Cómo filtra la gente lo que encuentra? | `--filters` | varios de `time`, `person`, `container`, `text`, `status` |
| ¿Qué nunca debe llegar al almacén, a un registro o a la salida? | `--never-store` | varios de `tokens`, `codes`, `secret-links`, `content` |
| ¿Qué entrada no fiable llega? | `--untrusted` | varios de `messages`, `files`, `links`, `names`; o `none` solo |

La misma herramienta, creada sin ninguna pregunta:

```sh
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 parecida [#aprende-de-una-herramienta-parecida]

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:

| Tipo de herramienta | Herramienta de referencia |
| --- | --- |
| mensajería | [`whatsapp-cli`](https://github.com/WireCatLabs/whatsapp-cli), luego [`tg-cli`](https://github.com/WireCatLabs/tg-cli) y [`max-cli`](https://github.com/WireCatLabs/max-cli) |
| archivos y documentos | [`drive-cli`](https://github.com/WireCatLabs/drive-cli) |
| reuniones | [`zoom-cli`](https://github.com/WireCatLabs/zoom-cli) |
| notas | [`cli-memo`](https://github.com/WireCatLabs/cli-memo) |
| correo, calendario, otra | todavía ninguna: elige la más cercana con tu agente |

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 persona [#cuatro-pasos-que-hace-una-persona]

`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](https://github.com/WireCatLabs/cli-base/blob/main/docs/standards/new-cli.md).
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és [#adónde-ir-después]

1. [Conceptos en cinco minutos](/llms.mdx/docs/es/build-concepts/content.md): cómo guarda WireCat registros de muchas fuentes.
2. [Añadir una fuente](/llms.mdx/docs/es/build-add-source/content.md): guarda los datos de tu servicio para que la búsqueda y los agentes los
   usen.
3. [Guardar tus propios datos](/llms.mdx/docs/es/build-own-data/content.md): dónde guarda tu herramienta lo que solo ella necesita.
4. [Iniciar sesión en un servicio](/llms.mdx/docs/es/build-sign-in/content.md): claves, el llavero y las cuentas.
5. [Cumplir los estándares y mantenerse al día](/llms.mdx/docs/es/build-stay-compliant/content.md): comprobaciones, versiones y
   actualizaciones.