agentuity-cli-cloud-session-list
List recent sessions. Requires authentication. Use for Agentuity cloud platform operations
When & Why to Use This Skill
The Agentuity Cloud Session List skill is a specialized developer tool designed for monitoring and auditing agent activities on the Agentuity cloud platform. It enables users to retrieve detailed logs of recent execution sessions with advanced filtering capabilities—including project ID, deployment status, trigger types, and success rates—providing essential visibility into agent performance and operational health.
Use Cases
- Real-time Monitoring: List the most recent agent sessions to ensure that automated workflows are executing correctly across the Agentuity platform.
- Error Diagnosis and Debugging: Filter sessions by 'success=false' to quickly isolate failed executions and investigate root causes in specific environments.
- Trigger Analysis: Audit how agents are being invoked by filtering for specific triggers such as API calls, cron jobs, or webhooks to optimize resource usage.
- Environment-Specific Auditing: Compare session history between production and development environments to validate deployments and track agent behavior during dev cycles.
| name | agentuity-cli-cloud-session-list |
|---|---|
| description | List recent sessions. Requires authentication. Use for Agentuity cloud platform operations |
| version | "0.0.103" |
| license | Apache-2.0 |
| allowed-tools | "Bash(agentuity:*)" |
| command | "agentuity cloud session list" |
| tags | "read-only fast requires-auth" |
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