# Agentuity CLI Cloud Stream List

> List recent streams with optional filtering. Requires authentication. Use for Agentuity cloud platform operations

- Skill: `agentuity/agentuity-cli-cloud-stream-list` (Agent Skill)
- Install (CLI): `npx skillmds@latest add agentuity/agentuity-cli-cloud-stream-list`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agentuity/agentuity-cli-cloud-stream-list/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- License: Apache-2.0
- Author: agentuity (https://skillmd.com/u/agentuity)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/agentuity/agentuity-cli-cloud-stream-list

---


# 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

```bash
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:

```bash
bunx @agentuity/cli cloud stream list
```

List 50 most recent streams:

```bash
bunx @agentuity/cli cloud stream ls --size 50
```

Filter by name:

```bash
bunx @agentuity/cli cloud stream list --name agent-logs
```

Filter by metadata:

```bash
bunx @agentuity/cli cloud stream list --metadata type=export
```

Output as JSON:

```bash
bunx @agentuity/cli cloud stream ls --json
```

## Output

Returns JSON object:

```json
{
  "streams": "array",
  "total": "number"
}
```

| Field | Type | Description |
|-------|------|-------------|
| `streams` | array | List of streams |
| `total` | number | Total count of matching streams |