Set up the furnace CLI

The furnace CLI wraps the REST API for terminal use and doubles as a local MCP server for agent hosts.

Authenticate

furnace auth login            # device flow, opens id.falcata.io
furnace auth whoami           # confirm identity and scope
furnace auth logout

furnace auth login accepts scoping flags — --read-only, --namespace=NS[,NS...], --scope=PERM[,PERM...] — which narrow the minted token; see Personal access tokens.

Credentials live in ~/.config/furnace/auth.json. Two environment variables matter:

• FURNACE_API_URL — API base (default https://api.falcata.io)
• FURNACE_PROFILE — named auth profiles (auth.<profile>.json), so separate accounts or environments can coexist

What it covers

Tasks and boards, media upload/replace/delete, workflow publish/start/status/cancel/restart/send-event, and furnace mcp for local agent hosts. Full syntax: Command reference.