Kubiya CLI Command Reference

This document provides a comprehensive reference for all Kubiya CLI commands, their subcommands, flags, and usage examples.

Global Flags

These flags can be used with any command:

Flag	Description
--help, -h	Show help for a command
--version, -v	Show CLI version information
--debug	Enable debug output for troubleshooting
--output, -o	Set output format (text, json)

Core Commands

kubiya

The root command for Kubiya CLI.

Usage:

kubiya [command] [flags]

Example:

kubiya --version

kubiya browse

Browse and execute tools interactively.

Usage:

kubiya browse

Aliases:

• b

kubiya chat

Chat with your AI teammates.

Usage:

kubiya chat [message] [flags]

Flags:

Flag	Description
--interactive, -i	Start an interactive chat session
--teammate, -t	Specify the teammate to chat with
--session, -s	Specify a session ID to continue a conversation
--clear-session	Clear the current session context
--list-sessions	List active chat sessions
--files, -f	Include files as context for the chat
--stream	Stream the response as it's generated

Examples:

# Start an interactive chat
kubiya chat --interactive

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

# Send a message with file context
kubiya chat "Explain this code" --files "main.py,config.yaml"

# Pipe stdin to chat
cat error.log | kubiya chat "What's wrong with this error log?"

kubiya config

Manage Kubiya CLI configuration.

Subcommands:

• set - Set a configuration value

• view - View current configuration

• reset - Reset configuration to defaults

Examples:

# Set API key
kubiya config set api-key YOUR_API_KEY

# View configuration
kubiya config view

kubiya update

Update the Kubiya CLI to the latest version.

Usage:

kubiya update

Source Management Commands

kubiya source

Manage your automation sources.

Aliases:

• sources

Subcommands:

• list - List all sources

• add - Add a new source

• describe - Get detailed information about a source

• delete - Delete a source

• sync - Sync a source with latest changes

• update - Update source configuration

• debug - Debug source issues

Examples:

# List all sources
kubiya source list

# Add a new source
kubiya source add --name "my-tools" --url "https://github.com/user/repo"

# Sync a source with latest changes
kubiya source sync SOURCE_ID

kubiya source list

List all sources.

Flags:

Flag	Description
--output, -o	Output format (text, json)
--full	Show full source details

kubiya source add

Add a new source.

Flags:

Flag	Description
--name, -n	Source name
--url	Git repository URL
--path	Local path to source
--branch, -b	Git branch
--auth-token	Authentication token for private repositories

kubiya source sync

Sync a source with latest changes.

Flags:

Flag	Description
--all	Sync all sources
--mode	Sync mode (interactive, non-interactive, ci)
--branch	Git branch to sync

Tool Management Commands

kubiya tool

Manage and execute tools.

Aliases:

• tools

Subcommands:

• list - List all tools

• search - Search for tools

• describe - Get detailed information about a tool

• execute - Execute a tool

Examples:

# List all tools
kubiya tool list

# Search for tools
kubiya tool search "kubernetes"

# Execute a tool
kubiya tool execute TOOL_ID

kubiya tool list

List all tools.

Flags:

Flag	Description
--output, -o	Output format (text, json)
--source, -s	Filter by source ID

kubiya tool search

Search for tools.

Flags:

Flag	Description
--output, -o	Output format (text, json)

kubiya tool execute

Execute a tool.

Flags:

Flag	Description
--args, -a	JSON string of arguments for the tool
--interactive, -i	Execute in interactive mode

kubiya generate

Generate Kubiya resources from templates.

Subcommands:

• tool - Generate a tool template

Flags:

Flag	Description
--name, -n	Name for the generated resource
--output, -o	Output directory

Knowledge Management Commands

kubiya knowledge

Manage knowledge base items.

Aliases:

• k

Subcommands:

• list - List all knowledge items

• get - Get a specific knowledge item

• create - Create a new knowledge item

• update - Update a knowledge item

• delete - Delete a knowledge item

• edit - Edit a knowledge item in your default editor

Examples:

# List all knowledge items
kubiya knowledge list

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

kubiya knowledge create

Create a new knowledge item.

Flags:

Flag	Description
--title, -t	Title of the knowledge item
--content, -c	Content file path or string
--tags	Tags for categorization

Runner Management Commands

kubiya runner

Manage automation runners.

Subcommands:

• list - List all runners

• describe - Get detailed information about a runner

• manifest - Get a runner manifest

Examples:

# List all runners
kubiya runner list

# Get runner details
kubiya runner describe RUNNER_ID

Secret Management Commands

kubiya secret

Manage secrets for your tools and integrations.

Aliases:

• secrets

Subcommands:

• list - List all secrets

• create - Create a new secret

• update - Update a secret

• delete - Delete a secret

Examples:

# List all secrets
kubiya secret list

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

Teammate Management Commands

kubiya teammate

Manage your AI teammates.

Aliases:

• teammates

Subcommands:

• list - List all teammates

• describe - Get detailed information about a teammate

• create - Create a new teammate

• update - Update a teammate

• delete - Delete a teammate

Examples:

# List all teammates
kubiya teammate list

# Get teammate details
kubiya teammate describe TEAMMATE_ID

Webhook Management Commands

kubiya webhook

Manage webhooks.

Aliases:

• webhooks

Subcommands:

• list - List all webhooks

• describe - Get detailed information about a webhook

• create - Create a new webhook

• update - Update a webhook

• delete - Delete a webhook

• execute - Execute a webhook

Examples:

# List all webhooks
kubiya webhook list

# Execute a webhook
kubiya webhook execute WEBHOOK_ID

Integration Management Commands

kubiya integration

Manage integrations with external services.

Subcommands:

• list - List all integrations

• setup - Set up a new integration

• describe - Get detailed information about an integration

Examples:

# List all integrations
kubiya integration list

# Set up a new integration
kubiya integration setup aws

Advanced Usage Commands

kubiya version

Display the current version of the Kubiya CLI.

Usage:

kubiya version

Exit Codes

Kubiya CLI uses the following exit codes:

Code	Description
0	Success
1	General error
2	Command line parsing error
3	API error
4	Authentication error
5	Network error

Environment Variables

You can configure the Kubiya CLI using these environment variables:

Variable	Description
KUBIYA_API_KEY	API key for authentication
KUBIYA_API_URL	Custom API endpoint URL
KUBIYA_DEBUG	Enable debug mode (true/false)
KUBIYA_OUTPUT_FORMAT	Default output format (text/json)

For more detailed information on each command, use the --help flag with any command or subcommand.