CLI Commands

`tinyfish agent run`

Execute a browser automation. By default the output streams as newline-delimited JSON — one object per event.

tinyfish agent run "goal" --url example.com

Flags

Flag	Description
`--url <url>`	Target URL to automate (required)
`--sync`	Wait for the run to complete and return the full result
`--async`	Submit only — return the `run_id` immediately without waiting
`--pretty`	Human-readable output instead of JSON

Output modes

Streaming (default)
Sync (--sync)
Async (--async)

One JSON object per line as events arrive. Use this when you want live progress or are piping to another tool.

tinyfish agent run "Extract the pricing" --url example.com/pricing

{"type":"STARTED","run_id":"abc123","run_url":"https://agent.tinyfish.ai/runs/abc123"}
{"type":"PROGRESS","run_id":"abc123","purpose":"Navigating to the pricing page"}
{"type":"COMPLETE","run_id":"abc123","status":"COMPLETED","result":{"price":"$99"},"run_url":"https://agent.tinyfish.ai/runs/abc123"}

Pressing Ctrl+C during a streaming run cancels the run server-side before exiting.

Waits for the run to finish and returns a single JSON object with the full result. Use this for scripts where you only care about the final output.

tinyfish agent run "Extract the pricing" --url example.com/pricing --sync

{"run_id":"abc123","run_url":"https://agent.tinyfish.ai/runs/abc123","status":"COMPLETED","result":{"price":"$99"},"num_of_steps":4}

Submits the run and returns immediately with the run_id. Use this when you want to fire-and-forget or manage polling yourself.

tinyfish agent run "Extract the pricing" --url example.com/pricing --async

{"run_id":"abc123","run_url":"https://agent.tinyfish.ai/runs/abc123","error":null}

`tinyfish agent run list`

List recent runs.

tinyfish agent run list

Flags

Flag	Description
`--status <status>`	Filter by status: `PENDING`, `RUNNING`, `COMPLETED`, `FAILED`, or `CANCELLED`
`--limit <n>`	Number of runs to return (default `20`, max `100`)
`--cursor <cursor>`	Pagination cursor from a previous response
`--pretty`	Human-readable output

Examples

tinyfish agent run list

`tinyfish agent run get <run_id>`

Get the full details of a specific run.

tinyfish agent run get abc123

Returns the complete run object including status, result, and metadata.

Flags

Flag	Description
`--pretty`	Human-readable output

Example

tinyfish agent run get abc123

`tinyfish agent run cancel <run_id>`

Cancel a run that is PENDING or RUNNING.

tinyfish agent run cancel abc123

{"run_id":"abc123","status":"CANCELLED","cancelled_at":"2024-01-15T10:30:00Z","message":null}

Flags

Flag	Description
`--pretty`	Human-readable output

Auth commands

Command	Description
`tinyfish auth login`	Open the API keys page and save a key interactively
`tinyfish auth set`	Read an API key from stdin and save it
`tinyfish auth status`	Check whether a key is configured and where it comes from
`tinyfish auth logout`	Remove the saved API key

Getting Started

CLI

Key Concepts

Guides

Examples

Resources

`tinyfish agent run`

Flags

Output modes

`tinyfish agent run list`

Flags

Examples

`tinyfish agent run get <run_id>`

Flags

Example

`tinyfish agent run cancel <run_id>`

Flags

Auth commands

Getting Started

CLI

Key Concepts

Guides

Examples

Resources

​tinyfish agent run

​Flags

​Output modes

​tinyfish agent run list

​Flags

​Examples

​tinyfish agent run get <run_id>

​Flags

​Example

​tinyfish agent run cancel <run_id>

​Flags

​Auth commands

`tinyfish agent run`

Flags

Output modes

`tinyfish agent run list`

Flags

Examples

`tinyfish agent run get <run_id>`

Flags

Example

`tinyfish agent run cancel <run_id>`

Flags

Auth commands