agentuity-cli-cloud-stream-list
List recent streams with optional filtering. Requires authentication. Use for Agentuity cloud platform operations
When & Why to Use This Skill
The agentuity-cli-cloud-stream-list skill provides a powerful interface for monitoring and managing data streams within the Agentuity cloud platform. It allows developers and operators to retrieve, filter, and audit recent agent activities and logs, ensuring high visibility into agentic workflows and system performance.
Use Cases
- Real-time Monitoring: Quickly list the most recent execution streams to track the live status of cloud-based agents.
- Targeted Debugging: Use metadata filtering (e.g., type=export) to isolate and investigate specific categories of stream data or errors.
- Activity Auditing: Retrieve historical stream data with pagination (size and offset) to generate reports or audit platform usage over time.
- Log Management: Filter streams by name to consolidate logs from specific agents or projects for easier troubleshooting.
| name | agentuity-cli-cloud-stream-list |
|---|---|
| description | List recent streams with optional filtering. Requires authentication. Use for Agentuity cloud platform operations |
| version | "0.0.103" |
| license | Apache-2.0 |
| allowed-tools | "Bash(agentuity:*)" |
| command | "agentuity cloud stream list" |
| tags | "read-only slow requires-auth" |
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 |