agentuity Cloud Stream List
List recent streams with optional filtering
Prerequisites
- Authenticated with
agentuity auth login - Project context required (run from project directory or use
--project-id)
Usage
agentuity cloud stream list [options]
Options
| Option | Type | Required | Default | Description |
|---|---|---|---|---|
--size |
number | Yes | - | maximum number of streams to return (default: 100) |
--offset |
number | Yes | - | number of streams to skip for pagination |
--name |
string | Yes | - | filter by stream name |
--metadata |
string | Yes | - | filter by metadata (format: key=value or key1=value1,key2=value2) |
Examples
List all streams:
bunx @agentuity/cli cloud stream list
List 50 most recent streams:
bunx @agentuity/cli cloud stream ls --size 50
Filter by name:
bunx @agentuity/cli cloud stream list --name agent-logs
Filter by metadata:
bunx @agentuity/cli cloud stream list --metadata type=export
Output as JSON:
bunx @agentuity/cli cloud stream ls --json
Output
Returns JSON object:
{
"streams": "array",
"total": "number"
}
| Field | Type | Description |
|---|---|---|
streams |
array | List of streams |
total |
number | Total count of matching streams |