Async Runs
Monitor and manage asynchronous agent processing jobs.
runs
List async job runs across agents.
lettactl runs [options]Options
| Flag | Type | Description |
|---|---|---|
| --active | boolean | Show only active/running jobs |
| --agent, -a | string | Filter by agent name |
| --limit, -l | number | Limit number of results |
| --watch, -w | boolean | Continuously poll and refresh the run list (Ctrl+C to stop) |
Examples
Active runs
lettactl runs --activeAgent runs
lettactl runs -a my-agentWatch mode
lettactl get runs --watch --activerun
Get details about a specific async run.
lettactl run <run-id> [options]Options
| Flag | Type | Description |
|---|---|---|
| --wait | boolean | Wait for the run to complete |
| --stream | boolean | Stream run output |
| --messages | boolean | Show messages produced by the run |
Examples
Check run
lettactl run abc-123Wait for completion
lettactl run abc-123 --wait --messagestrack
Track async runs until completion. Auto-exits when all runs reach a terminal state. Exit code 1 if any run failed (CI/CD friendly).
lettactl track [run-ids...] [options]Options
| Flag | Type | Description |
|---|---|---|
| --agent, -a | string | Track all active runs for an agent |
Examples
Track specific runs
lettactl track <run-id-1> <run-id-2>Track by agent
lettactl track --agent my-agentrun-delete
Cancel and delete a specific async run.
lettactl run-delete <run-id>Examples
Cancel run
lettactl run-delete abc-123