For developers
Invoices, clients, expenses and a quarterly tax estimate, without leaving the shell. The same account, the same data and the same rules as the web app: an invoice created here opens in the browser as an ordinary invoice, because it is one.
npm install -g nyrutnyrut loginNode.js 20 or later. Package: npmjs.com/package/nyrut.
nyrut login opens a loopback server on 127.0.0.1 and sends you to the browser you're already signed into. The web app names the port and asks before handing the session over: a link alone is never enough.
The session is stored at ~/.config/nyrut/session.json with mode 0600. nyrut logout removes it.
List invoices, most urgent first.
nyrut invoices --status overduenyrut invoices --client etéreo --allnyrut invoices --json | jq '.[].numero'Overdue first, then unpaid, then the rest. The footer is the point: what you are owed, and how much of it is late.
Draw one invoice.
nyrut invoice 2026-014nyrut invoice 014A partial number works if it matches exactly one invoice; if it matches several, you are told which rather than guessed at. This is a preview — the PDF is made in the browser, see nyrut invoice open.
Create an invoice.
nyrut invoice newnyrut invoice new --client etéreo --issuer nafsIt saves a DRAFT. The number is reserved, nothing is issued, and sending is a separate deliberate step. VAT and withholding come from where your workspace files and where the client is — not from a default.
Email the invoice to the client.
nyrut invoice send 2026-014nyrut invoice send 2026-014 --to pagos@cliente.comShows recipient and total and asks first, because sending cannot be undone. A draft becomes issued the moment it leaves.
Mark an invoice paid.
nyrut invoice pay 2026-014nyrut invoice pay 2026-014 --date 2026-08-01Public link to share the invoice.
nyrut invoice link 2026-014nyrut invoice link 2026-014 | pbcopyCreates the link the first time and reuses it after. Anyone holding it can see the invoice — the URL is the credential. The warning goes to stderr so piping copies only the link.
Open the invoice in the browser.
nyrut invoice open 2026-014Where the PDF lives, and where you can edit it.
Your clients and what each still owes.
Your issuing entities.
The type column decides which tax forms apply: an individual files modelo 130, a company does not.
Expenses you have recorded.
VAT by quarter, for one issuer.
nyrut summarynyrut summary --year 2025 --issuer nafsOne issuer at a time, always: VAT is filed per tax ID, so adding two together produces a number matching no return anyone will ever file. Invoices in another currency are excluded and counted — converting them needs the ECB rate per date, which the app fetches. An estimate to check against, not a filing.
Sign in through your browser.
Opens a loopback server on 127.0.0.1 and sends you to the browser you are already signed into. The web app names the port and asks before handing anything over. The token is stored at ~/.config/nyrut/session.json with mode 0600.
Forget the session on this machine.
Who you are signed in as.
--json works on every listing, and it's a separate code path: no colour, no padding, no headers.| cat, on a dumb terminal and under NO_COLOR.CI, NO_COLOR or --plain.nyrut invoice link 2026-014 | pbcopy copies the URL and nothing else.--stauts=paid won't silently list every invoice.nyrut summary runs the app's own 303 and 130 calculations, one issuer at a time (VAT is filed per tax ID). Invoices in another currency are excluded and counted, because converting them needs the ECB rate of each invoice's date. It's an estimate to check against, not a filing.