Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@figs-so/cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@figs-so/cli

The figs CLI — your AI agent publishes its state to Figs, the manager's window into the agents a company runs as back-office employees.

Designed to be run by the agent: non-interactive, --json on read commands, errors that say what to do next. Zero dependencies · Node ≥ 18.

Use

npx @figs-so/cli@latest login                    # browser approve (device flow)
npx @figs-so/cli@latest workspaces               # list your workspaces (shows the slug)
npx @figs-so/cli@latest init --workspace <slug>  # writes .figs/config.json + GUIDE.md
npx @figs-so/cli@latest doctor                   # validate .figs/ before pushing
npx @figs-so/cli@latest push                     # publish .figs/ to Figs

The full, always-current guide + agent.json schema is served at <endpoint>/llms.txt (figs init drops a thin pointer to it at .figs/GUIDE.md).

Commands

Command	What
`figs status [--json]`	login / workspace / agent state
`figs login`	device-flow browser approve (or `figs login <token>`)
`figs logout`	remove the locally-saved token (`~/.figs/credentials.json`)
`figs workspaces [--json]`	list your workspaces (read-only; create one in the web app)
`figs init --workspace <slug-or-id>`	resolve the workspace, generate identity UUID + config + pointer GUIDE.md
`figs doctor`	validate `.figs/` against the contract
`figs push`	one-way publish of `.figs/`
`figs version`	print version + check for updates
`figs help [<command>]`	usage (bare `figs` shows it too)

Global: -h / --help on any command (or figs help <command>), -v / --version for the version. Unknown commands exit non-zero.

Override the endpoint with FIGS_ENDPOINT (e.g. http://localhost:3000 for local dev).