Visió general
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 maneja l'API REST v1
des del teu terminal. És agent-first — sortida JSON estable, exit codes
semàntics i descobriment en una sola crida — i inspirat en Stripe: l'arbre de
comandes complet es genera des de l'especificació OpenAPI, així que mai es
desincronitza de la superfície real.
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ó
Els canals empaquetats s'activen amb la primera release publicada. Fins llavors, compila des del codi.
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.
Errors i límits de peticions
Formes d'error JSON-RPC mapejades des del contracte v1, la taula completa de codis i throttling per token / per pla amb Retry-After.
Ús
L'arbre de comandes de factuarea — list, show, create, accions de domini, descàrregues binàries, pujades multipart, l'escape hatch genèric api i el manifest commands --json.