TryBiut CLI

Manage TryBiut from the terminal — taxes, invoices, movements, reports. Secure token storage, no password ever saved.

https://img.shields.io/badge/node-%3E%3D18-green.svg" />

Install in one command

No npm publish needed:

npx -y github:JMonde/trybiut-cli --help
# or install globally
npm i -g github:JMonde/trybiut-cli
trybiut --help

After npm publish, this becomes npx -y trybiut-cli / npm i -g trybiut-cli.

Quick start

# 1. Create your account
open https://trybiut.com/onboarding/chat

# 2. Log in (stores a local token, password is not saved)
#    or create a long-lived token at https://trybiut.com/dashboard/integrations
npx -y github:JMonde/trybiut-cli login

# 3. Verify
npx -y github:JMonde/trybiut-cli me
npx -y github:JMonde/trybiut-cli dashboard

# No login needed
npx -y github:JMonde/trybiut-cli status
npx -y github:JMonde/trybiut-cli tax-preview --income 35000 --country ES
npx -y github:JMonde/trybiut-cli calendar --year 2026

Commands

Command	Auth	Description
login	no	Authenticate and save token
logout	—	Clear local token
config [--show-token] [--set-base-url URL]	—	Show or set config
status	no	API health check
me	yes	Logged-in profile
tax-preview --income N [--country ES] [--legal-form autonomo]	no	Saving estimate
tax-calc --amount N [--region España] [--business-type autonomo] [--period annual] [--social]	no	Tax breakdown
calendar [--year 2026]	no	Fiscal calendar
pricing	no	Pricing coverage
dashboard	yes	Tax dashboard
invoices [--limit 20]	yes	List invoices
movements [--limit 20]	yes	List movements
history	yes	Filed forms
report	yes	Full tax report
subscription	yes	Plan status

Security

• Password is used once to obtain a Supabase session token, then discarded.
• Token is stored at ~/.config/trybiut/config.json (Windows: %APPDATA%/trybiut/config.json) with mode 600.
• Private commands refuse to run without a token and never send data anonymously.
• Use TRYBIUT_API_TOKEN env var to override the stored token (useful for CI).
• config redacts the token by default.
• The MCP server (github:JMonde/trybiut-mcp) reuses the same token via TRYBIUT_API_TOKEN.

Config

Env overrides:

• TRYBIUT_BASE_URL (default https://trybiut.com)
• TRYBIUT_API_TOKEN (overrides stored token)
• SUPABASE_URL / SUPABASE_ANON_KEY (rarely needed)

Development

npm install
npm run build
npm run smoke
node dist/index.js --help

Publishing (optional):

npm login
npm publish --access public

License

MIT © 2026 TryBiut — see LICENSE.