freeticket-clilisted
Install: claude install-skill AppFreeticket/agent-skills
# FreeTicket CLI (`ft`)
`ft` is FreeTicket's terminal client. It consumes the **B2B REST API v1** and is
generated from its OpenAPI 3.1 contract, so every endpoint exists as a command.
**Reads and writes both work**: every resource has `list`/`get` plus
`create`/`update`/`delete` and resource actions (`events publish`,
`sales cancel`/`refund`, `staff set-role`), and every list takes `--csv`. The CLI
mirrors what the web app does — anything you can do on the page, you can do here.
## When to use this skill
- The user wants real data: "how many sales do I have?", "list my events", "export buyers".
- The user wants to **change** something: "create an event", "publish it", "refund sale X", "raise a ticket-type price", "suspend a tenant".
- You need to run `ft ...` or automate a report/mutation for `jq`/scripts.
- Manage the session (`ft login`/`logout`/`config`) or switch workspace.
- Another skill (e.g. `freeticket-eventos`) needs live data to audit or an action to perform.
## Setup (once)
```bash
# No install needed (Node >= 20). Always pin @latest so you never hit a stale
# npx cache or an old global build:
npx @freeticket/cli@latest login # browser device flow: prints a code,
# opens the browser, you approve, done.
# CI/automation: … login --key ft_live_xxxxx
npx @freeticket/cli@latest whoami # user + accessible workspaces
# Optional global install for a short `ft` alias:
npm instal