Teammates Commands

kubiya teammates

Manage your AI Teammates, including their configuration, instructions, and associated tools/integrations.

Available Commands

Command	Description
`list`	List all available teammates
`get`	Get detailed information about a specific teammate
`create`	Create a new teammate from a YAML definition file
`update`	Update an existing teammate using a YAML definition file
`apply`	Create or update a teammate (upsert operation)
`delete`	Delete a teammate

Command Examples

# List all available teammates
kubiya teammates list
 
# List teammates with specific label
kubiya teammates list --label team=platform
 
# Show in JSON format
kubiya teammates list --output json

Teammate YAML Structure

Example Teammate Definition

name: ops-assistant
description: Operations assistant for the DevOps team
version: 1.0.0
 
# Instructions for the teammate (prompt/system message)
instructions: |
  You are an operations assistant for the DevOps team.
  Help with infrastructure management, monitoring, and deployments.
  Always follow company security protocols.
 
# Tools this teammate can use
tools:
  - aws-ec2
  - kubernetes
  - github
 
# Integrations to connect this teammate with
integrations:
  - aws-prod
  - github-main
 
# Suggested conversation starters
conversation_starters:
  - How is our AWS infrastructure doing today?
  - Can you check the status of our Kubernetes cluster?
  - Deploy the latest version of our application
 
# Optional, for teammate filtering
labels:
  team: devops
  environment: production

Common Options

These options apply to most teammates commands:

Option	Description
`--file`, `-f`	Path to a YAML file with teammate configuration
`--output`, `-o`	Output format: json, yaml, table (default: table)
`--label`	Filter or set labels (key=value format)
`--fields`	Specify fields to display (for get and list)
`--force`	Skip confirmation prompts

Deleting a teammate is permanent and cannot be undone. Use with caution.

Teammates Commands

Teammates Commands

Available Commands

Command Examples

Teammate YAML Structure

Example Teammate Definition

Common Options

On this page