> ## 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

> Manage agents, teams, and projects - the foundation of your Kubiya platform

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

```bash theme={null}
# 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
```

```bash theme={null}
# 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
```

```bash theme={null}
# 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

```bash theme={null}
# 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

```bash theme={null}
# View specific agent
kubiya agent get <agent-id>

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

### Create Agent

<Tabs>
  <Tab title="Interactive">
    ```bash theme={null}
    # Guided interactive creation
    kubiya agent create --interactive
    ```
  </Tab>

  <Tab title="From File">
    ```bash theme={null}
    # Create from YAML definition
    kubiya agent create --file agent.yaml
    ```

    ```yaml theme={null}
    # agent.yaml
    name: deployment-agent
    description: Handles production deployments
    model: gpt-4
    skills:
      - kubernetes
      - helm
      - monitoring
    environment_id: prod-env
    ```
  </Tab>
</Tabs>

### Update Agent

```bash theme={null}
# Update agent configuration
kubiya agent update <agent-id> --file agent.yaml
```

### Delete Agent

```bash theme={null}
# Delete agent
kubiya agent delete <agent-id>

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

### Execute with Agent

```bash theme={null}
# 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

```bash theme={null}
# List all teams
kubiya team list

# JSON output
kubiya team list --output json
```

### Get Team Details

```bash theme={null}
# View specific team
kubiya team get <team-id>
```

### Create Team

```bash theme={null}
# Create from file
kubiya team create --file team.yaml
```

```yaml theme={null}
# team.yaml
name: devops-team
description: DevOps automation team
members:
  - agent-id-1
  - agent-id-2
  - agent-id-3
```

### Update Team

```bash theme={null}
# Update team configuration
kubiya team update <team-id> --file team.yaml
```

### Delete Team

```bash theme={null}
# Delete team
kubiya team delete <team-id>
```

### Execute with Team

```bash theme={null}
# Execute task with team
kubiya team exec <team-id> "Complete production deployment"
```

## Projects

Organizational units for grouping resources.

### List Projects

```bash theme={null}
# List all projects
kubiya project list

# JSON output
kubiya project list --output json
```

### Get Project Details

```bash theme={null}
# View project details
kubiya project get <project-id>
```

### Create Project

```bash theme={null}
# 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

```bash theme={null}
# 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

<CardGroup cols={2}>
  <Card title="Execute Tasks" icon="bolt" href="/cli/exec">
    Execute tasks with your agents using automatic planning
  </Card>

  <Card title="Execution Resources" icon="play" href="/cli/execution-resources">
    Manage executions, jobs, and workers
  </Card>

  <Card title="Capabilities" icon="puzzle-piece" href="/cli/capabilities">
    Add skills, models, and policies to agents
  </Card>

  <Card title="Infrastructure" icon="server" href="/cli/infrastructure">
    Configure environments and platform operations
  </Card>
</CardGroup>