Documentation Index Fetch the complete documentation index at: https://docs.kubiya.ai/llms.txt
Use this file to discover all available pages before exploring further.
Execution resources handle task scheduling, monitoring, and distributed execution across your worker infrastructure. This includes one-time executions, scheduled jobs with cron triggers, and worker management.
Quick Start # List executions kubiya execution list --status running
Output: 📊 Executions ID AGENT STATUS STARTED a1b2c3d4-e5f6-7890-abcd-ef1234567890 DevOps Agent running 2025-01-15 14:23:45 b2c3d4e5-f6a7-8901-bcde-f12345678901 Platform Agent running 2025-01-15 14:20:12
# View execution logs kubiya execution logs < execution-i d > --follow # Create scheduled job kubiya job create --file job.yaml # List scheduled jobs kubiya job list
Output: ⏰ Scheduled Jobs (0) No jobs found. Create your first job with: kubiya job create --file job.yaml
# Check worker status (requires queue ID) kubiya worker status --queue-id < queue-i d >
Output: 📊 Worker Status Queue ID: default-queue Status: Running Workers: 2 active Last Heartbeat: 2025-01-15 14:25:30
Executions One-time task runs with real-time streaming and logging.
List Executions # List all executions kubiya execution list # Filter by agent kubiya execution list --agent < agent-i d > # Filter by status kubiya execution list --status running kubiya execution list --status completed kubiya execution list --status failed
Get Execution Details # View execution details kubiya execution get < execution-i d > # JSON output kubiya execution get < execution-i d > --output json
View Execution Logs # View logs kubiya execution logs < execution-i d > # Follow logs in real-time kubiya execution logs < execution-i d > --follow
Check Execution Status # Get current status kubiya execution status < execution-i d >
Cancel Execution # Cancel running execution kubiya execution cancel < execution-i d >
Retry Failed Execution # Retry with same parameters kubiya execution retry < execution-i d >
Jobs Scheduled or recurring tasks with cron-based triggers.
List Jobs # List all jobs kubiya job list # JSON output kubiya job list --output json
Get Job Details # View job configuration kubiya job get < job-i d >
Create Job # Create from file kubiya job create --file job.yaml
# job.yaml name : daily-backup description : Run daily database backup schedule : "0 0 * * *" # Daily at midnight agent_id : backup-agent prompt : "Run full database backup" enabled : true
Common Cron Expressions: Schedule Cron Expression Description Every hour 0 * * * *Run at the start of every hour Daily at 2 AM 0 2 * * *Run once per day at 2:00 AM Weekly on Monday 0 0 * * 1Run every Monday at midnight Monthly on 1st 0 0 1 * *Run first day of each month Every 15 minutes */15 * * * *Run 4 times per hour Business hours 0 9-17 * * 1-5Every hour during business days
Update Job # Update job configuration kubiya job update < job-i d > --file job.yaml
Pause Job # Pause scheduled job kubiya job pause < job-i d >
Resume Job # Resume paused job kubiya job resume < job-i d >
Trigger Job Manually # Run job immediately kubiya job trigger < job-i d >
Delete Job # Delete job kubiya job delete < job-i d >
Workers Execution engines that process agent tasks. Workers can be persistent (always running) or on-demand (ephemeral).
Start Worker # Start worker kubiya worker start # Start with specific queue kubiya worker start --queue < queue-i d >
Stop Worker # Stop running worker kubiya worker stop
Check Worker Status # Get worker status (requires queue ID) kubiya worker status --queue-id < queue-i d >
View Worker Logs # View logs kubiya worker logs # Follow logs in real-time kubiya worker logs --follow
Best Practices
Monitor for failed executions and long-running tasks
Check execution logs regularly for errors
Test jobs manually before enabling schedules
Use appropriate cron expressions for schedules
Set realistic timeouts for jobs
Use on-demand workers for occasional tasks
Use persistent workers for high-frequency operations
Keep workers updated with latest features
Deploy multiple workers for critical workloads
Command Reference # Executions kubiya execution list [--status running | completed | failed] kubiya execution list --agent < i d > kubiya execution get < i d > kubiya execution logs < i d > [--follow] kubiya execution status < i d > kubiya execution cancel < i d > kubiya execution retry < i d > # Jobs kubiya job list kubiya job get < i d > kubiya job create --file job.yaml kubiya job update < i d > --file job.yaml kubiya job delete < i d > kubiya job pause < i d > kubiya job resume < i d > kubiya job trigger < i d > # Workers kubiya worker start [--queue < i d > ] kubiya worker stop kubiya worker status --queue-id < i d > kubiya worker logs [--follow]
Next Steps
Core Resources Manage agents, teams, and projects
Worker Management Detailed worker deployment and configuration
Smart Execution Execute tasks with automatic planning
Capabilities Add skills, models, and policies
