# Flow CLI

The Flow CLI package in this repository is `@flow/cli` and exposes the `flow` binary.

## Install And Login

Build or install the CLI in a workspace that contains the package, then run:

```bash
flow auth login
flow auth login --api-key <fl_key>
flow profile
```

Configuration supports named profiles and `FLOW_API_URL` precedence through the CLI config helpers. The default API URL is `https://flow.pixelbrain.cz`.

## Resource Groups

- `flow assignments` for agents.
- `flow jobs` for runs and run inspection.
- `flow cases` for queues and cases.
- `flow files`, `flow sandboxes`, and `flow connections`.
- `flow skills`, `flow revisions`, `flow revision-integrations`, and `flow secrets`.
- `flow teams`, `flow process-mapping`, `flow plugins`, and `flow agent-folders`.
- `flow api <METHOD> <path>` for low-level API calls.

Human-readable tables are the default. Use `--json` for scripting:

```bash
flow jobs list --json | jq '.data[] | .id'
flow api GET /teams
```

Use the web UI for exploratory setup and the CLI for repeatable automation.