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.
Core resources are the foundation of your Kubiya automation platform. Agents are AI-powered entities that execute tasks, teams enable agent collaboration, and projects help organize resources by logical groupings.
Quick Start # List agents kubiya agent list
Output: Agents (4) ID NAME ENVIRONMENT 039f75ea-b90b-46b5-97c8-ed5475468f3c Kubiya Default Environment 17ee8c4f-d7c7-4a12-9cc6-8e6e0e2a6068 shaked-test Default Environment 3a3fe0ed-9e8f-4cbd-96fc-f3e3e5c06bdf test Default Environment e63ec06c-f2c4-42d1-8c14-7acda75c33ac DevOps Automation Agent Default Environment
# Create agent from file kubiya agent create --file agent.yaml # Execute with agent kubiya agent exec < agent-i d > "Deploy to staging" # List teams kubiya team list
Output: Teams (2) NAME DESCRIPTION DevOps Team Main DevOps automation team Platform Team Platform engineering team
# List projects kubiya project list
Output: 🔍 Fetching projects... ╔════════════════════════════╗ ║ 🏗️ Projects (1) ║ ╚════════════════════════════╝ ID NAME DESCRIPTION CREATED 2667caff... Default Default project for agents and teams 2025-11-20 22:09
Agents AI-powered entities that execute tasks using configured skills and models.
List Agents # Basic listing kubiya agent list # Output formats kubiya agent list --output json kubiya agent list --output yaml kubiya agent list --output table
Get Agent Details # View specific agent kubiya agent get < agent-i d > # JSON output kubiya agent get < agent-i d > --output json
Create Agent # Guided interactive creation kubiya agent create --interactive
# Create from YAML definition kubiya agent create --file agent.yaml
# agent.yaml name : deployment-agent description : Handles production deployments model : gpt-4 skills : - kubernetes - helm - monitoring environment_id : prod-env
Update Agent # Update agent configuration kubiya agent update < agent-i d > --file agent.yaml
Delete Agent # Delete agent kubiya agent delete < agent-i d > # Force delete without confirmation kubiya agent delete < agent-i d > --force
Execute with Agent # Execute task with specific agent kubiya agent exec < agent-i d > "Deploy to staging" # Stream execution logs kubiya agent exec < agent-i d > "Deploy to staging" --stream
Teams Groups of agents that collaborate on complex tasks.
List Teams # List all teams kubiya team list # JSON output kubiya team list --output json
Get Team Details # View specific team kubiya team get < team-i d >
Create Team # Create from file kubiya team create --file team.yaml
# team.yaml name : devops-team description : DevOps automation team members : - agent-id-1 - agent-id-2 - agent-id-3
Update Team # Update team configuration kubiya team update < team-i d > --file team.yaml
Delete Team # Delete team kubiya team delete < team-i d >
Execute with Team # Execute task with team kubiya team exec < team-i d > "Complete production deployment"
Projects Organizational units for grouping resources.
List Projects # List all projects kubiya project list # JSON output kubiya project list --output json
Get Project Details # View project details kubiya project get < project-i d >
Create Project # Create from file kubiya project create --file project.yaml
Best Practices
Use descriptive naming: prod-deployment-agent, staging-devops-team
Include environment prefix: prod-*, staging-*, dev-*
Use hyphens not underscores: my-agent not my_agent
Group by project for better organization
Use teams to organize agents by functional area
Store agent YAML definitions in version control
Test agents in dev/staging before production
Command Reference # Agents kubiya agent list [--output json | yaml | table] kubiya agent get < i d > kubiya agent create --file agent.yaml kubiya agent create --interactive kubiya agent update < i d > --file agent.yaml kubiya agent delete < i d > [--force] kubiya agent exec < i d > "prompt" [--stream] kubiya agent chat < i d > # Teams kubiya team list [--output json | yaml] kubiya team get < i d > kubiya team create --file team.yaml kubiya team update < i d > --file team.yaml kubiya team delete < i d > kubiya team exec < i d > "prompt" # Projects kubiya project list [--output json | yaml] kubiya project get < i d > kubiya project create --file project.yaml
Next Steps
Execute Tasks Execute tasks with your agents using automatic planning
Execution Resources Manage executions, jobs, and workers
Capabilities Add skills, models, and policies to agents
Infrastructure Configure environments and platform operations
