Kubiya LogoKubiya Developer Docs

CLI Reference

Command-line interface for the Kubiya Agentic Platform.

Kubiya CLI

Current Version: v1.2.0

•

Release Notes

•

Examples

The Kubiya Command-Line Interface (CLI) provides command-line access to the Kubiya Agentic Platform. It allows developers, DevOps engineers, and platform administrators to manage resources, interact with AI agents, and automate workflows directly from the terminal or within CI/CD pipelines.

Installation

Get started with installing the CLI.

Authentication

Connect to your Kubiya instance.

Commands

Explore all available commands.

Configuration

Configure CLI behavior.

Examples

See practical usage examples.

Quick Start

Install the CLI

# For macOS with Homebrew
brew tap kubiyabot/kubiya && brew install kubiya
 
# For Linux (Debian/Ubuntu)
sudo apt-get update && sudo apt-get install kubiya-cli
 
# Using curl installer (Linux/macOS)
curl -sSL https://get.kubiya.ai | bash
 
# For Windows with Scoop
scoop bucket add kubiya https://github.com/kubiyabot/scoop-bucket
scoop install kubiya
 
# Docker container
docker pull kubiyabot/cli:latest
docker run --rm -it kubiyabot/cli:latest

See installation for more options and detailed instructions.

Authenticate

# Interactive login (recommended)
kubiya auth login
 
# Or set up using your API key
kubiya config set api-key YOUR_API_KEY

See authentication for more options.

Start Using Commands

# Chat with an agent interactively
kubiya chat --interactive
 
# or specify a teammate
kubiya chat --teammate "devops-expert" --interactive
 
# Execute tools
kubiya tools execute deploy-app --args '{"app_name":"my-app"}'
 
# Browse tools interactively
kubiya browse

Core Features

Interactive Chat

# Start an interactive chat session
kubiya chat --interactive
 
# Chat with a specific teammate
kubiya chat --teammate "devops-expert" --interactive
 
# Send message with context files
kubiya chat "Explain this code" --files "main.py,config.yaml"

Tool Execution

# List available tools
kubiya tools list
 
# Execute a specific tool
kubiya tools execute deploy-app --args '{"app_name":"my-app"}'
 
# Browse tools interactively
kubiya browse

Knowledge Management

# List knowledge items
kubiya knowledge list
 
# Create new knowledge
kubiya knowledge create --title "AWS Best Practices" --content "content.md"
 
# Search knowledge
kubiya knowledge search "kubernetes scaling"

Teammate Management

# List all teammates/agents
kubiya teammates list
 
# Create a new teammate
kubiya teammates create --name "devops-expert" --file "teammate-config.yaml"
 
# Chat with a specific teammate
kubiya chat --teammate "devops-expert" --interactive

Multi-Environment Support

# Create environment profiles
kubiya config create-profile development
kubiya config set api-key DEV_KEY --profile development
 
# Switch between environments
kubiya config use-profile production
 
# Use a profile for a specific command
kubiya tools execute deploy-app --profile development

CI/CD Integration

# Execute in CI pipeline
kubiya tools execute deploy-service \
  --args '{"service":"api","env":"production","version":"1.2.0"}' \
  --output json
  
# Create notification
kubiya chat "Deployment completed successfully" \
  --teammate "deployment-notifier" \
  --channel "#deployments"

Need Help?

Use kubiya --help or append --help to any command to see detailed usage information and examples.

Getting Started with Kubiya

Learn how to get started with the Kubiya platform for AI agents orchestration, management, and consumption.

Authentication

Authenticating the Kubiya CLI with the Kubiya Platform.

On this page