# `frontline agents`

Manage agents

```bash
frontline agents [options] [command]
```

## `frontline agents list`

List all agents (JSON by default; use --pretty/--table for human-readable output)

```bash
frontline agents list [options]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--status <status>` | Filter by status (e.g. active, inactive, draft) |  |
| `--pretty` | Pretty human-readable output |  |
| `--table` | Render as table |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug information (redacted token) |  |


## `frontline agents create`

Create an agent and select it as active

```bash
frontline agents create [options]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--name <name>` | Agent name |  |
| `--no-use` | Do not set the created agent as active |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


## `frontline agents use`

Select the active agent for flow commands

```bash
frontline agents use [options] <agentId>
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


## `frontline agents describe`

Describe the active agent or --agent-id

```bash
frontline agents describe [options] [agentId]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


## `frontline agents update`

Update the active agent or --agent-id

```bash
frontline agents update [options]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--name <name>` | Agent name |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


## `frontline agents delete`

Delete the active agent or --agent-id

```bash
frontline agents delete [options]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


## `frontline agents deploy`

Publish or pause the active agent

```bash
frontline agents deploy [options]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--offline <true | false>` | Set true to pause, false to publish |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


## `frontline agents settings`

Manage channel settings

```bash
frontline agents settings [options] [command]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


### `frontline agents settings get`

Get all channel settings or one channel

```bash
frontline agents settings get [options] [channel]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


### `frontline agents settings update`

Update channel settings from JSON

```bash
frontline agents settings update [options] <channel>
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--data <json>` | Channel settings payload JSON |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


### `frontline agents settings list-channels`

List configurable channel names

```bash
frontline agents settings list-channels [options]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


## `frontline agents theme`

Manage agent theme

```bash
frontline agents theme [options] [command]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


### `frontline agents theme get`

Get agent theme

```bash
frontline agents theme get [options]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


### `frontline agents theme update`

Update agent theme from JSON

```bash
frontline agents theme update [options]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--data <json>` | Theme payload JSON |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


## `frontline agents agent-setting`

Manage agent model, instructions, tools, and connected accounts

```bash
frontline agents agent-setting [options] [command]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


### `frontline agents agent-setting get`

Get agent setting

```bash
frontline agents agent-setting get [options]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


### `frontline agents agent-setting update`

Update agent setting from JSON (merges with current settings)

```bash
frontline agents agent-setting update [options]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--data <json>` | Agent setting patch JSON |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


## `frontline agents flows`

List flows for a specific agent

```bash
frontline agents flows [options] [command] [agentId]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


### `frontline agents flows list`

List flows for the active agent or --agent-id

```bash
frontline agents flows list [options]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--status <status>` | Filter by flow status |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


### `frontline agents flows create`

Create a flow for the active agent or --agent-id

```bash
frontline agents flows create [options]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--name <name>` | Flow name |  |
| `--description <description>` | Flow description |  |
| `--no-use` | Do not set the created flow as active |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


### `frontline agents flows use`

Select the active flow for the active agent or --agent-id

```bash
frontline agents flows use [options] <flowId>
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


### `frontline agents flows describe`

Describe the active flow or --flow-id

```bash
frontline agents flows describe [options]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--flow-id <id>` | Flow ID. Defaults to the active flow |  |
| `--include-nodes` | Include flow nodes |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


### `frontline agents flows update`

Update the active flow or --flow-id

```bash
frontline agents flows update [options]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--flow-id <id>` | Flow ID. Defaults to the active flow |  |
| `--name <name>` | Flow name |  |
| `--description <description>` | Flow description |  |
| `--status <status>` | Flow status (ACTIVE, DRAFT, SUSPENDED, DELETED) |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


### `frontline agents flows delete`

Delete the active flow or --flow-id

```bash
frontline agents flows delete [options]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--flow-id <id>` | Flow ID. Defaults to the active flow |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


### `frontline agents flows graph`

Get the active flow graph

```bash
frontline agents flows graph [options]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--flow-id <id>` | Flow ID. Defaults to the active flow |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


### `frontline agents flows nodes`

Manage flow nodes

```bash
frontline agents flows nodes [options] [command]
```

#### `frontline agents flows nodes list`

List nodes for the active flow

```bash
frontline agents flows nodes list [options]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--flow-id <id>` | Flow ID. Defaults to the active flow |  |


#### `frontline agents flows nodes create`

Create a node in the active flow

```bash
frontline agents flows nodes create [options]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--flow-id <id>` | Flow ID. Defaults to the active flow |  |
| `--data <json>` | Node JSON payload |  |


#### `frontline agents flows nodes update`

Update a node in the active flow

```bash
frontline agents flows nodes update [options] <nodeId>
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--flow-id <id>` | Flow ID. Defaults to the active flow |  |
| `--data <json>` | Partial node JSON payload |  |


#### `frontline agents flows nodes delete`

Delete a node and its connected edges

```bash
frontline agents flows nodes delete [options] <nodeId>
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--flow-id <id>` | Flow ID. Defaults to the active flow |  |


### `frontline agents flows edges`

Manage flow edges

```bash
frontline agents flows edges [options] [command]
```

#### `frontline agents flows edges add`

Add or replace an edge by handle

```bash
frontline agents flows edges add [options]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--flow-id <id>` | Flow ID. Defaults to the active flow |  |
| `--source <nodeId>` | Source node ID |  |
| `--source-handle <handleId>` | Source handle ID |  |
| `--target <nodeId>` | Target node ID |  |
| `--target-handle <handleId>` | Target handle ID |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


#### `frontline agents flows edges remove`

Remove an edge

```bash
frontline agents flows edges remove [options]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--flow-id <id>` | Flow ID. Defaults to the active flow |  |
| `--source <nodeId>` | Source node ID |  |
| `--source-handle <handleId>` | Source handle ID |  |
| `--target <nodeId>` | Target node ID |  |
| `--target-handle <handleId>` | Target handle ID |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


## `frontline agents variables`

Manage variables for the active agent

```bash
frontline agents variables [options] [command]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


### `frontline agents variables list`

List agent variables

```bash
frontline agents variables list [options]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--filter-text <text>` | Filter by name or description |  |
| `--is-default <true | false>` | Filter default variables |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


### `frontline agents variables all`

List all agent variables including defaults

```bash
frontline agents variables all [options]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


### `frontline agents variables create`

Create an agent variable

```bash
frontline agents variables create [options]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--name <name>` | Variable name |  |
| `--description <description>` | Variable description |  |
| `--pattern <pattern>` | Optional validation pattern |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


### `frontline agents variables describe`

Describe an agent variable

```bash
frontline agents variables describe [options] <variableId>
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


### `frontline agents variables update`

Update an agent variable

```bash
frontline agents variables update [options] <variableId>
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--name <name>` | Variable name |  |
| `--description <description>` | Variable description |  |
| `--pattern <pattern>` | Optional validation pattern |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


### `frontline agents variables delete`

Delete an agent variable

```bash
frontline agents variables delete [options] <variableId>
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


### `frontline agents variables check-name`

Check whether an agent variable name exists

```bash
frontline agents variables check-name [options] <name>
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


## `frontline agents run`

Run an agent: send a message and print its reply (Overview/Playground)

```bash
frontline agents run [options] [command]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--message <text>` | Message to send to the agent |  |
| `--conversation-id <id>` | Continue an existing conversation |  |
| `--contact-id <id>` | Link the conversation to a People record |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


### `frontline agents run close`

Close a conversation

```bash
frontline agents run close [options] <conversationId>
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


## `frontline agents conversations`

List an agent's conversations. Uses the active agent unless --agent-id is passed

```bash
frontline agents conversations [options] [command]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--is-closed <bool>` | Filter by closed state (true/false) |  |
| `--start-date <date>` | Start date (YYYY-MM-DD) |  |
| `--end-date <date>` | End date (YYYY-MM-DD) |  |
| `--search <text>` | Full-text search over message content and conversation name |  |
| `--channels <list>` | Comma-separated channels. Valid: LIVE_CHAT, SHARED, OVERVIEW, API, WHATSAPP, INSTAGRAM, MESSENGER, SLACK, MAX_EXTENSION |  |
| `--feedback <rating>` | Filter by feedback rating. Valid: POSITIVE, NEGATIVE |  |
| `--page <n>` | Page number |  |
| `--page-size <n>` | Page size |  |
| `--pretty` | Pretty human-readable output |  |
| `--table` | Render as table |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug information (redacted token) |  |


### `frontline agents conversations get`

Get a single conversation with its message transcript

```bash
frontline agents conversations get [options] <conversationId>
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--include-events` | Debug view: include non-message events (flow enter/exit, intents, tool calls, errors) in the transcript |  |
| `--pretty` | Pretty human-readable output |  |
| `--table` | Render as table |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug information (redacted token) |  |


### `frontline agents conversations trace`

Get a single message's full execution trace (audit log)

```bash
frontline agents conversations trace [options] <conversationId> <messageId>
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--pretty` | Pretty human-readable output |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug information (redacted token) |  |


## `frontline agents intents`

Manage intents for the active agent

```bash
frontline agents intents [options] [command]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


### `frontline agents intents list`

List agent intents

```bash
frontline agents intents list [options]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--filter-text <text>` | Filter by intent name |  |
| `--include-used-status <true | false>` | Include intents already used by flows |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


### `frontline agents intents all`

List all agent intents

```bash
frontline agents intents all [options]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--include-used-status <true | false>` | Include intents already used by flows |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


### `frontline agents intents create`

Create an agent intent

```bash
frontline agents intents create [options]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--name <name>` | Intent name |  |
| `--description <description>` | Intent description |  |
| `--phrases <json>` | JSON array of training phrases |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


### `frontline agents intents describe`

Describe an agent intent

```bash
frontline agents intents describe [options] <intentId>
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


### `frontline agents intents update`

Update an agent intent

```bash
frontline agents intents update [options] <intentId>
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--name <name>` | Intent name |  |
| `--description <description>` | Intent description |  |
| `--phrases <json>` | JSON array of phrase objects |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


### `frontline agents intents delete`

Delete an agent intent

```bash
frontline agents intents delete [options] <intentId>
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


### `frontline agents intents generate-phrases`

Generate suggested phrases for an intent

```bash
frontline agents intents generate-phrases [options]
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--agent-id <id>` | Agent ID. Defaults to the active agent |  |
| `--name <name>` | Intent name |  |
| `--samples <json>` | JSON array of sample phrases |  |
| `--amount <number>` | Amount of phrases to generate | `10` |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug info on stderr (token is redacted) |  |
| `--pretty` | Pretty-print human-readable output (instead of default JSON) |  |
| `--table` | Render list results as a table (implies --pretty) |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |


## `frontline agents analytics`

Get analytics for a specific agent

```bash
frontline agents analytics [options] <agentId>
```

**Options**

| Flag | Description | Default |
|  --- | --- | --- |
| `--start-date <date>` | Start date (YYYY-MM-DD) |  |
| `--end-date <date>` | End date (YYYY-MM-DD) |  |
| `--pretty` | Pretty human-readable output |  |
| `--table` | Render as table |  |
| `--json` | Output raw JSON (default behavior — accepted as a no-op) |  |
| `--api-key <key>` | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) |  |
| `--base-url <url>` | Advanced: override Public API base URL for this run |  |
| `--profile <name>` | Credentials profile: uses that profile's saved API key and Public API base URL (see `frontline auth profiles list`) |  |
| `--debug` | Show debug information (redacted token) |  |