# Agentes bienvenidos. > Tu agente de IA puede llevar tu Nyrut desde la terminal: hacer facturas, enviarlas, marcarlas cobradas, decirte quién te debe y qué IVA te toca. Con tu cuenta y las mismas reglas que la web. Claude Code, Codex o el agente que uses pueden llevar tu Nyrut desde la terminal: hacer y enviar facturas, apuntar lo cobrado, decirte quién te debe y qué te toca pagar este trimestre. Con tu cuenta, tus datos y las mismas reglas que la web. ``` npm install -g nyrut nyrut login ``` ## tu agente, en la terminal > Hazle a Estudio Norte la factura de octubre: 12 horas de diseño web a 60 €. Enséñamela y, si está bien, mándasela. ``` $ nyrut invoice new --client "estudio norte" --line "Diseño web, octubre; 12; 60" Borrador 2026-018 · Estudio Norte · 720,00 € + IVA 151,20 − IRPF 108,00 = 763,20 € $ nyrut invoice send 2026-018 --yes Enviada a administracion@estudionorte.es ``` Hecho: la 2026-018, de 763,20 €, ya está en el correo de Estudio Norte. Vence el 17 de noviembre; si quieres, ese día miro si está cobrada. ## Tu agente hace en Nyrut lo que harías tú. - **Facturar**: Crea la factura con sus líneas, con el IVA y la retención que tocan según dónde está el cliente. Queda en borrador hasta que se envía. `nyrut invoice new --line "…"` - **Enviarla**: Al correo del cliente, o al que le digas. Antes enseña a quién y cuánto, porque enviar no se deshace. `nyrut invoice send 2026-018` - **Apuntar lo cobrado**: Marca una factura como pagada, con la fecha en que llegó el dinero. `nyrut invoice pay 2026-014` - **Decirte quién te debe**: Lo vencido primero, y cuánto de lo que te deben va con retraso. `nyrut invoices --status overdue` - **Compartirla**: El enlace público de la factura, para pegarlo donde quieras. `nyrut invoice link 2026-018` - **Repasar clientes y gastos**: Tus clientes con lo que debe cada uno, y los gastos apuntados. `nyrut clients · nyrut expenses` - **Cuadrar el trimestre**: El 303 y el 130 estimados, con el mismo cálculo que la web. Para revisar, no para presentar. `nyrut summary` Lo que aún no hace desde la terminal: apuntar gastos (con la foto del ticket, en la web va solo) ni el PDF. Para eso, `nyrut invoice open` abre la factura en el navegador. ## Pídeselo así En tus palabras. El agente traduce a órdenes, lee los datos en JSON y te cuenta el resultado. - Dime quién me debe dinero, desde cuándo y cuánto en total. Lo más urgente, arriba. - Factura a Bodegas Sur lo mismo que el mes pasado, con fecha de hoy, y déjala en borrador para que la revise. - ¿Cuánto IVA me va a tocar pagar este trimestre? ¿Y si me pagan la 2026-014 antes del 30? - Hazme una tabla con lo que he facturado a cada cliente este año, de más a menos. - Marca como cobrada la 2026-011: me la pagaron ayer. ## Con red. - **Entras tú, en tu navegador**: `nyrut login` te lleva a la web, donde ya tienes la sesión, y te pregunta antes de dársela a la terminal. Un enlace solo nunca basta. - **Lo que crea, en borrador**: Una factura nueva no sale de la terminal emitida: enviarla es otro paso, y la orden enseña a quién y cuánto antes de hacerlo. - **Es tu sesión**: Lo que hace el agente lo haces tú: mismas facturas, mismas reglas, y todo queda en la web. Pídele que te enseñe una factura antes de enviarla. - **La cierras cuando quieras**: La sesión se guarda solo en tu máquina, legible solo por ti. `nyrut logout` la borra. ## ¿Y si el agente eres tú? La terminal también es para personas: lo pendiente con lo urgente arriba, cada factura dibujada en su idioma, y nada que estorbe a tus scripts. - Todo listado sale en JSON con `--json`: sin colores, sin relleno, sin cabeceras. - El color nunca dice nada que no diga el texto: se lee igual con `| cat` o con `NO_COLOR`. - Una opción mal escrita es un error, no un listado de todo: `--stauts=paid` no pasa. - Las animaciones se paran solas cuando nadie mira: sin TTY, en tubería o en CI. ## Y la web, en Markdown Si tu agente lee la web para entender Nyrut, cada página tiene su versión en Markdown: añade `.md` a la dirección o pídela con `Accept: text/markdown`. Y `llms.txt` resume qué es Nyrut y dónde está cada cosa. [llms.txt](https://www.nyrut.com/llms.txt) · [Esta página, en Markdown](https://www.nyrut.com/agentes.md) ## Empieza en un minuto. 1. Instala la CLI: `npm install -g nyrut` 2. Entra con tu cuenta: `nyrut login` 3. Díselo a tu agente: `nyrut --help` «Usa la CLI de Nyrut (`nyrut --help`) para llevar mis facturas. Antes de enviar nada, enséñamelo.» ## Todas las órdenes Cada una con `--help`. Las opciones y los ejemplos, en la referencia completa (en inglés, como la propia CLI). - [`nyrut invoices [options]`](https://www.nyrut.com/cli#invoices): Las facturas, lo más urgente arriba - [`nyrut invoice `](https://www.nyrut.com/cli#invoice): Dibuja una factura - [`nyrut invoice new [options]`](https://www.nyrut.com/cli#invoice-new): Crea una factura - [`nyrut invoice send [options]`](https://www.nyrut.com/cli#invoice-send): La manda al cliente por correo - [`nyrut invoice pay [options]`](https://www.nyrut.com/cli#invoice-pay): La marca como cobrada - [`nyrut invoice link `](https://www.nyrut.com/cli#invoice-link): Su enlace público - [`nyrut invoice open `](https://www.nyrut.com/cli#invoice-open): La abre en el navegador - [`nyrut clients`](https://www.nyrut.com/cli#clients): Tus clientes y lo que debe cada uno - [`nyrut issuers`](https://www.nyrut.com/cli#issuers): Tus emisores - [`nyrut expenses [options]`](https://www.nyrut.com/cli#expenses): Los gastos apuntados - [`nyrut summary [options]`](https://www.nyrut.com/cli#summary): El IVA de cada trimestre, por emisor - [`nyrut login`](https://www.nyrut.com/cli#login): Entra con tu navegador - [`nyrut logout`](https://www.nyrut.com/cli#logout): Olvida la sesión en esta máquina - [`nyrut whoami`](https://www.nyrut.com/cli#whoami): Con quién has entrado [Referencia completa](https://www.nyrut.com/cli.md) ## Que trabaje otro. Tu cuenta de Nyrut es la misma en la web, en el móvil y en la terminal. Diez días gratis, sin tarjeta. [Empieza gratis](https://www.nyrut.com/login?alta=1)