What you can do in Kubiya CLI

This guide provides detailed information on all features and capabilities of the Kubiya CLI, including practical examples and common use cases.

Kubiya CLI Screenshot

Interactive Chat with AI Teammates

Chat with your AI teammates directly from the terminal to get assistance with DevOps tasks, coding problems, infrastructure management, and more.

Starting an Interactive Chat Session

# Start a general interactive chat
kubiya chat --interactive

# Chat with a specific teammate
kubiya chat --teammate "DevOps-Expert" --interactive

# Continue a previous session
kubiya chat --interactive --session abc123

# Send a one-off message
kubiya chat "How do I create an AWS S3 bucket?"

Adding Context to Your Conversations

# Chat with file context
kubiya chat "What does this Terraform code do?" --files "main.tf,variables.tf"

# Chat with stdin pipe
cat error.log | kubiya chat "What's causing these errors?"

# Chat with URL context
kubiya chat "Explain this repository" --files "https://github.com/user/repo"

Session Management

# List active chat sessions
kubiya chat --list-sessions

# Continue a specific session
kubiya chat --interactive --session SESSION_ID

# Clear the current session context
kubiya chat --interactive --clear-session

Source Management

Sources contain the tools and capabilities that your AI teammates can use to help you. Manage your sources efficiently with these commands.

Listing and Inspecting Sources

# List all sources
kubiya source list

# Get detailed information about a source
kubiya source describe SOURCE_ID

# List sources in JSON format
kubiya source list --output json

Adding New Sources

# Add a source from a Git repository
kubiya source add --name "aws-tools" --url "https://github.com/organization/aws-tools"

# Add a source from a local directory
kubiya source add --name "local-tools" --path "/path/to/tools"

# Add a source with authentication
kubiya source add --name "private-tools" --url "https://github.com/organization/private-tools" --auth-token "github_pat_xxx"

Syncing and Updating Sources

# Sync a specific source with latest changes
kubiya source sync SOURCE_ID

# Sync all sources
kubiya source sync --all

# Sync in non-interactive mode (for CI/CD)
kubiya source sync SOURCE_ID --mode ci

Debugging Sources

# Debug a source to identify issues
kubiya source debug SOURCE_ID

# Update source configuration
kubiya source update SOURCE_ID --branch main

Tool Execution

Execute automated tools from your sources to accomplish various tasks.

Discovering Tools

# List all available tools
kubiya tool list

# Search for tools by keyword
kubiya tool search "kubernetes"

# Get detailed information about a tool
kubiya tool describe TOOL_ID

Executing Tools

# Execute a tool interactively
kubiya tool execute TOOL_ID

# Execute a tool with specific arguments
kubiya tool execute deploy-app --args '{"app_name":"frontend","environment":"staging"}'

# Browse and execute tools interactively
kubiya browse

Creating Custom Tools

# Generate a new tool template
kubiya generate tool --name "my-custom-tool"

Knowledge Management

Manage your team's knowledge base to share information and documentation.

Working with Knowledge Items

# List all knowledge items
kubiya knowledge list

# View a specific knowledge item
kubiya knowledge get ITEM_ID

# Create a new knowledge item
kubiya knowledge create --title "AWS Best Practices" --content "content.md"

# Edit an existing knowledge item
kubiya knowledge edit ITEM_ID

# Delete a knowledge item
kubiya knowledge delete ITEM_ID

Runner Management

Runners execute your tools in various environments. Manage them effectively with these commands.

Listing and Inspecting Runners

# List all runners
kubiya runner list

# Get detailed information about a runner
kubiya runner describe RUNNER_ID

Working with Runner Manifests

# Get a runner manifest
kubiya runner manifest RUNNER_ID

Secret Management

Securely store and manage secrets for your tools and integrations.

Managing Secrets

# List all secrets
kubiya secret list

# Create a new secret
kubiya secret create --name "aws-credentials" --value "value" --description "AWS access credentials"

# Update an existing secret
kubiya secret update SECRET_ID --value "new-value"

# Delete a secret
kubiya secret delete SECRET_ID

Teammate Management

Manage your AI teammates and their capabilities.

Working with Teammates

# List all teammates
kubiya teammate list

# Get detailed information about a teammate
kubiya teammate describe TEAMMATE_ID

# Create a new teammate
kubiya teammate create --name "Infrastructure-Expert" --description "Specialist in cloud infrastructure"

# Update teammate properties
kubiya teammate update TEAMMATE_ID --description "Updated description"

Webhook Management

Manage webhooks to integrate Kubiya with external systems.

Working with Webhooks

# List all webhooks
kubiya webhook list

# Get detailed information about a webhook
kubiya webhook describe WEBHOOK_ID

# Create a new webhook
kubiya webhook create --name "slack-notification" --url "https://hooks.slack.com/services/xxx"

# Execute a webhook
kubiya webhook execute WEBHOOK_ID

# Delete a webhook
kubiya webhook delete WEBHOOK_ID

Practical End-to-End Examples

Here are comprehensive examples showing how Kubiya CLI can be used in real-world scenarios.

Example 1: Setting Up a New Project

# Create a new source for the project
kubiya source add --name "project-tools" --url "https://github.com/organization/project-tools"

# Create secrets for the project
kubiya secret create --name "db-password" --value "secure-password"
kubiya secret create --name "api-key" --value "api-key-value"

# Create knowledge items for the project
kubiya knowledge create --title "Project Architecture" --content "architecture.md"

# Chat with a teammate about the project setup
kubiya chat --teammate "DevOps-Expert" --interactive

Example 2: Troubleshooting Infrastructure Issues

# Check AWS S3 bucket status
kubiya tool execute aws-s3-status

# Analyze error logs
cat error.log | kubiya chat "What's wrong with these logs?"

# Execute remediation tool
kubiya tool execute fix-s3-permissions --args '{"bucket":"my-bucket"}'

Example 3: CI/CD Pipeline Integration

# In your CI/CD pipeline script
kubiya source sync project-tools --mode ci
kubiya tool execute deploy-app --args '{"app":"frontend","environment":"production"}'
kubiya webhook execute deployment-notification --data '{"status":"success","version":"1.2.3"}'

Example 4: Collaborative Debugging

# Start an interactive session with context
kubiya chat --teammate "Backend-Expert" --interactive --files "app.js,server.js,error.log"

# Execute diagnostic tool based on recommendations
kubiya tool execute diagnose-nodejs-memory

# Document the solution
kubiya knowledge create --title "Resolving Memory Leaks" --content "solution.md"

Advanced Usage Tips

• Pipeline Inputs/Outputs: Chain commands together using pipes for complex workflows

• Scripting: Include Kubiya CLI commands in your scripts and automation

• CI/CD Integration: Use non-interactive modes for CI/CD pipelines

• Custom Configurations: Set up environment-specific configurations using the config command

• Debug Mode: Use --debug flag for verbose logging when troubleshooting

For full reference documentation and updates, run kubiya --help or visit the official documentation.