Environments

Execution contexts with variables, secrets, and integrations for agent operations.

Quick Start

# List environments
kubiya environment list

Output:

🌍 Environments (1)

ID                                    NAME                 DESCRIPTION
2667caff-8d0e-4b5e-9c1a-3e5f0a7b2c9d  Default Environment  Default environment for agents

# Get environment details
kubiya environment get <environment-id>

# Create environment
kubiya environment create --file environment.yaml

List Environments

# List all environments
kubiya environment list

# JSON output
kubiya environment list --output json

Output:

🌍 Environments (3)

ID                                    NAME                    DESCRIPTION
2667caff-8d0e-4b5e-9c1a-3e5f0a7b2c9d  Default Environment    Default environment for agents
a1b2c3d4-e5f6-7890-abcd-ef1234567890  Production            Production environment with AWS
b2c3d4e5-f6a7-8901-bcde-f12345678901  Staging               Staging environment for testing

Get Environment Details

View complete environment configuration including variables, secrets, and integrations:

# View environment configuration
kubiya environment get <environment-id>

Output:

🌍 Environment Details

ID: 2667caff-8d0e-4b5e-9c1a-3e5f0a7b2c9d
Name: Production
Description: Production environment with AWS integration

Variables:
  DATABASE_URL: postgres://prod-db.example.com:5432/mydb
  API_ENDPOINT: https://api.example.com
  LOG_LEVEL: info

Secrets:
  - aws-credentials
  - db-password
  - api-key

Integrations:
  - github
  - slack
  - aws

Created: 2025-01-10 14:23:45
Updated: 2025-01-15 09:12:30

Create Environment

Create a new environment from a YAML configuration file:

# Create from file
kubiya environment create --file environment.yaml

environment.yaml:

name: production
description: Production environment
variables:
  DATABASE_URL: "postgres://..."
  API_ENDPOINT: "https://api.example.com"
  LOG_LEVEL: "info"
secrets:
  - aws-credentials
  - db-password
integrations:
  - github
  - slack

Example with multiple integrations:

name: staging
description: Staging environment for testing
variables:
  DATABASE_URL: "postgres://staging-db.example.com:5432/mydb"
  API_ENDPOINT: "https://staging-api.example.com"
  DEBUG: "true"
secrets:
  - staging-aws-credentials
  - staging-db-password
integrations:
  - github
  - slack
  - datadog
  - pagerduty

Update Environment

Update an existing environment configuration:

# Update environment configuration
kubiya environment update <environment-id> --file environment.yaml

The update will merge new configuration with existing settings. To replace completely, delete and recreate the environment.

Delete Environment

# Delete environment
kubiya environment delete <environment-id>

Deleting an environment does not delete agents or teams using it. They will need to be reconfigured with a new environment.

Best Practices

Organization

Separate environments by stage (dev, staging, production)
Use descriptive names and detailed descriptions
Document variable purposes in environment descriptions
Maintain environment definitions in version control

Security

Never store sensitive data in plain text variables - always use secrets
Rotate secrets regularly with automated processes
Use role-based access control for environment management
Encrypt secrets at rest
Enable and review audit logs for environment changes

Variable Management

Use consistent naming conventions (UPPER_SNAKE_CASE for env vars)
Document required vs optional variables
Provide sensible defaults where possible
Use environment-specific values (don’t share credentials across envs)

Integration Management

Only add integrations that are actually used
Review integration permissions regularly
Test integrations after adding or updating
Document integration setup requirements

Command Reference

# List environments
kubiya environment list [--output json|yaml]

# Get environment details
kubiya environment get <id>

# Create environment
kubiya environment create --file env.yaml

# Update environment
kubiya environment update <id> --file env.yaml

# Delete environment
kubiya environment delete <id>

Next Steps

Core Resources

Create agents and teams in environments

Capabilities

Configure skills and policies for environments

Workers

Deploy workers for environment execution

On-Demand Execution

Execute tasks in configured environments

Getting Started

On-Demand Execution

Control Plane

Control Plane Resources

Context Graph

Cognitive Memory

Advanced

Quick Start

List Environments

Get Environment Details

Create Environment

Update Environment

Delete Environment

Best Practices

Organization

Security

Variable Management

Integration Management

Command Reference

Next Steps

Core Resources

Capabilities

Workers

On-Demand Execution

​Quick Start

​List Environments

​Get Environment Details

​Create Environment

​Update Environment

​Delete Environment

​Best Practices

​Organization

​Security

​Variable Management

​Integration Management

​Command Reference

​Next Steps

Core Resources

Capabilities

Workers

On-Demand Execution

Quick Start

List Environments

Get Environment Details

Create Environment

Update Environment

Delete Environment

Best Practices

Organization

Security

Variable Management

Integration Management

Command Reference

Next Steps