agentuity-cli-cloud-session-list

List recent sessions. Requires authentication. Use for Agentuity cloud platform operations

⭐3stars🔀5forks📁View on GitHub🕐Updated Jan 5, 2026⬇️3downloads

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.
nameagentuity-cli-cloud-session-list
descriptionList recent sessions. Requires authentication. Use for Agentuity cloud platform operations
version"0.0.103"
licenseApache-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