Agents & CLI
AI agents welcome.
Claude Code, Codex or whichever agent you use can run your Nyrut from the terminal: create and send invoices, record payments, tell you who owes you and what's due this quarter. With your account, your data and the same rules as the web app.
npm install -g nyrut
> Invoice Estudio Norte for October: 12 hours of web design at €60. Show it to me and, if it looks right, send it.
● nyrut invoice new --client "estudio norte" --line "Web design, October; 12; 60"
⎿ ✓ Draft 2026-018 · Estudio Norte · €720.00 + VAT 151.20 − IRPF 108.00 = €763.20
● nyrut invoice send 2026-018 --yes
⎿ ✓ Sent to administracion@estudionorte.es
● Done: invoice 2026-018, €763.20, is in Estudio Norte's inbox. It's due on 17 November; I can check then whether it's been paid.
Your agent does in Nyrut what you would.
Invoice
Creates the invoice with its line items, with the VAT and withholding that apply given where the client is. It stays a draft until it's sent.
$ nyrut invoice new --line "…"Send it
To the client's email, or to whoever you say. It shows who and how much first, because sending can't be undone.
$ nyrut invoice send 2026-018Record payments
Marks an invoice paid, on the date the money arrived.
$ nyrut invoice pay 2026-014Tell you who owes you
Overdue first, and how much of what you're owed is late.
$ nyrut invoices --status overdueShare it
The invoice's public link, to paste wherever you like.
$ nyrut invoice link 2026-018Review clients and expenses
Your clients with what each still owes, and the expenses you've recorded.
$ nyrut clients · nyrut expensesCheck the quarter
Spain's 303 and 130, estimated with the same maths as the web app. To check against, not to file.
$ nyrut summary
What it can't do from the terminal yet: record expenses (in the web app a receipt photo does it for you) or make the PDF. For those, nyrut invoice open opens the invoice in your browser.
Ask in your own words
The agent turns it into commands, reads the data as JSON and tells you the result.
- Tell me who owes me money, since when and how much in total. Most urgent first.
- Invoice Bodegas Sur the same as last month, dated today, and leave it as a draft for me to check.
- How much VAT will I owe this quarter? And if 2026-014 gets paid before the 30th?
- Make me a table of what I've invoiced each client this year, highest first.
- Mark 2026-011 as paid: the money arrived yesterday.
With a safety net.
- You sign in, in your browser
nyrut loginsends you to the web app, where you're already signed in, and asks before handing the session to the terminal. A link alone is never enough.- New invoices are drafts
- Nothing leaves the terminal already issued: sending is a separate step, and the command shows who and how much before it does.
- It's your session
- What the agent does, you do: same invoices, same rules, and everything shows up in the web app. Ask it to show you an invoice before sending it.
- Sign out whenever you like
- The session is stored only on your machine, readable only by you.
nyrut logoutremoves it.
What if the agent is you?
The terminal is for people too: what's pending with the urgent on top, each invoice drawn in its own language, and nothing in your scripts' way.
- Every listing comes out as JSON with
--json: no colour, no padding, no headers. - Colour never carries meaning: it reads the same through
| cator underNO_COLOR. - A mistyped option is an error, not a list of everything:
--stauts=paiddoesn't fly. - Animation stops by itself when nobody's watching: no TTY, piped, or in CI.
And the website, in Markdown
If your agent reads the website to understand Nyrut, every page has a Markdown version: add .md to the address or ask for it with Accept: text/markdown. And llms.txt sums up what Nyrut is and where everything lives.
Start in a minute.
1. Install the CLI
npm install -g nyrut2. Sign in with your account
nyrut login3. Tell your agent
nyrut --help
“Use the Nyrut CLI (nyrut --help) to handle my invoices. Show me before sending anything.”
Every command
Each one with --help. Options and examples in the full reference.
nyrut invoices [options]List invoices, most urgent firstnyrut invoice <number>Draw one invoicenyrut invoice new [options]Create an invoicenyrut invoice send <number> [options]Email the invoice to the clientnyrut invoice pay <number> [options]Mark an invoice paidnyrut invoice link <number>Public link to share the invoicenyrut invoice open <number>Open the invoice in the browsernyrut clientsYour clients and what each still owesnyrut issuersYour issuing entitiesnyrut expenses [options]Expenses you have recordednyrut summary [options]VAT by quarter, for one issuernyrut loginSign in through your browsernyrut logoutForget the session on this machinenyrut whoamiWho you are signed in as
Let someone else do it.
Your Nyrut account is the same on the web, on your phone and in the terminal. Ten days free, no card.
Start free