Resum de la CLI
Instal·la i autentica el CLI oficial factuarea — maneja l'API REST v1 des del teu terminal amb brew, npm o un instal·lador curl. Agent-first, inspirat en Stripe.
El CLI oficial factuarea opera l’API REST des del teu terminal, amb sortida JSON, codis de sortida semàntics i un catàleg de comandes consultable generat des del spec integrat a cada versió.
L'última versió estable és v0.2.0.
Prefereixes que un agent d'IA manegi Factuarea directament? El CLI està fet per a això. Consulta Agents i scripting per al contracte JSON i els exit codes, i el servidor MCP per a l'alternativa basada en tools.
Instal·lació
macOS i Linux:
brew install --cask factuarea/tap/factuareaQualsevol plataforma amb Node 20 o superior:
npm i -g @factuarea/cli # o: npx @factuarea/cli <comanda>Instal·la un binari signat a ~/.local/bin:
curl -fsSL https://github.com/factuarea/factuarea-cli/releases/latest/download/install.sh | shEls binaris estan signats (cosign) i venen amb checksums.txt a
Releases.
Requereix Go 1.26 o superior:
git clone https://github.com/factuarea/factuarea-cli && cd factuarea-cli
make build # genera ./factuareaLa notarització a macOS i la signatura Authenticode a Windows arriben en una
fase posterior. De moment, a macOS fes servir brew o npm, o executa
xattr -d com.apple.quarantine ./factuarea sobre un binari solt.
Autenticació
El CLI fa servir la teva API key de Factuarea. El prefix de la key decideix l'entorn — no hi ha cap flag a part:
fact_test_…→ el sandbox aïllat: dades de prova, sense efectes reals (no transmet a l'AEAT, no envia email, no entrega webhooks).fact_live_…→ producció: dades reals.
Inicia sessió
factuarea login # et demana la key en un prompt ocultLa key es llegeix en un prompt ocult — mai es passa com a argument visible.
Es desa al keyring del sistema (amb fallback a ~/.config/factuarea/config.toml,
permisos 600). Suporta múltiples perfils amb --profile.
O defineix una variable d'entorn
Per a entorns no interactius:
export FACTUAREA_API_KEY=fact_test_xxxxxxxxxxxxxxxxxxxxxxxxVerifica
factuarea whoami # mostra el compte i l'entorn (TEST/LIVE)Comença tota integració amb una key fact_test_. La superfície de
comandes és idèntica a producció — canvia el prefix a fact_live_ només quan
el teu flux funcioni de principi a fi. Les mutacions en producció (amb una key
fact_live_) requereixen a més el flag explícit --live com a xarxa de
seguretat.
Què segueix
Ús
L'arbre de comandes generat — list, show, create, accions de domini,
descàrregues binàries, l'escape hatch api i commands --json.
Devloop
Prova webhooks en local sense desplegar ni ngrok: listen reenvia els
esdeveniments a la teva màquina, trigger produeix esdeveniments reals en
sandbox.
Agents i scripting
El contracte agent-first: JSON estable per stdout, errors estructurats per stderr, exit codes semàntics, scope-check i confirmació tipada.
Alternativa mitjançant REST
El catàleg de comandes del CLI prové del seu spec integrat. A la referència de setembre de 2026 està disponible la versió v0.2.0 i el spec de la branca principal conté 414 entrades; falten 38 endpoints REST a les comandes generades. Consulta factuarea commands --json per a la versió instal·lada. Fes servir la comanda HTTP genèrica per a un endpoint REST disponible que falti en aquest catàleg:
factuarea api get /v1/stores