| name | agentuity-cli-cloud-session-list |
| description | List recent sessions. Requires authentication. Use for Agentuity cloud platform operations |
| version | 0.0.110 |
| license | Apache-2.0 |
| allowed-tools | Bash(agentuity:*) |
| metadata | [object Object] |
Cloud Session List
List recent sessions
Prerequisites
- Authenticated with
agentuity auth login
Usage
agentuity cloud session list [options]
Options
| Option | Type | Required | Default | Description |
|---|---|---|---|---|
--count |
number | No | 10 |
Number of sessions to list (1–100) |
--projectId |
string | Yes | - | Filter by project ID |
--deploymentId |
string | Yes | - | Filter by deployment ID |
--trigger |
string | Yes | - | Filter by trigger type (api, cron, webhook) |
--env |
string | Yes | - | Filter by environment |
--threadId |
string | Yes | - | Filter by thread ID |
--agentIdentifier |
string | Yes | - | Filter by agent identifier |
--devmode |
boolean | Yes | - | Filter by dev mode (true/false) |
--success |
boolean | Yes | - | Filter by success status (true/false) |
--startAfter |
string | Yes | - | Filter by start time after (ISO 8601) |
--startBefore |
string | Yes | - | Filter by start time before (ISO 8601) |
Examples
List 10 most recent sessions:
bunx @agentuity/cli cloud session list
List 25 most recent sessions:
bunx @agentuity/cli cloud session list --count=25
Filter by project:
bunx @agentuity/cli cloud session list --project-id=proj_*
Filter by deployment:
bunx @agentuity/cli cloud session list --deployment-id=*
Only successful sessions:
bunx @agentuity/cli cloud session list --success=true
Only production sessions:
bunx @agentuity/cli cloud session list --devmode=false
Only API triggered sessions:
bunx @agentuity/cli cloud session list --trigger=api
Only production environment:
bunx @agentuity/cli cloud session list --env=production
Output
Returns: array