Skip to main content
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-id> "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-id>

# JSON output
kubiya agent get <agent-id> --output json

​
Create Agent

# Guided interactive creation
kubiya agent create --interactive

​
Update Agent

# Update agent configuration
kubiya agent update <agent-id> --file agent.yaml

​
Delete Agent

# Delete agent
kubiya agent delete <agent-id>

# Force delete without confirmation
kubiya agent delete <agent-id> --force

​
Execute with Agent

# Execute task with specific agent
kubiya agent exec <agent-id> "Deploy to staging"

# Stream execution logs
kubiya agent exec <agent-id> "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-id>

​
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-id> --file team.yaml

​
Delete Team

# Delete team
kubiya team delete <team-id>

​
Execute with Team

# Execute task with team
kubiya team exec <team-id> "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-id>

​
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 <id>
kubiya agent create --file agent.yaml
kubiya agent create --interactive
kubiya agent update <id> --file agent.yaml
kubiya agent delete <id> [--force]
kubiya agent exec <id> "prompt" [--stream]
kubiya agent chat <id>

# Teams
kubiya team list [--output json|yaml]
kubiya team get <id>
kubiya team create --file team.yaml
kubiya team update <id> --file team.yaml
kubiya team delete <id>
kubiya team exec <id> "prompt"

# Projects
kubiya project list [--output json|yaml]
kubiya project get <id>
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