Skip to main content
Infrastructure resources handle platform-level operations including execution environments with variables and secrets, and the organizational knowledge graph powered by Neo4j.

​
Quick Start

# List environments
kubiya environment list
Output: 
🌍 Environments (1)

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

# List available integrations
kubiya graph integrations list
Output: 
📊 Available Integrations (32)

INTEGRATION       DESCRIPTION
aws              Amazon Web Services cloud platform
github           GitHub repository management
slack            Slack team communication
kubernetes       Kubernetes cluster management
terraform        Infrastructure as code
datadog          Monitoring and analytics
pagerduty        Incident management
jira             Issue tracking and project management
[... 24 more integrations]

# View graph statistics
kubiya graph stats

# List all node labels
kubiya graph labels

# Execute custom Cypher query
kubiya graph query --query "MATCH (n:Agent) RETURN n LIMIT 10"

​
Environments

Execution contexts with variables, secrets, and integrations.

​
List Environments

# List all environments
kubiya environment list

# JSON output
kubiya environment list --output json

​
Get Environment Details

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

​
Create Environment

# 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"
secrets:
  - aws-credentials
  - db-password
integrations:
  - github
  - slack

​
Update Environment

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

​
Delete Environment

# Delete environment
kubiya environment delete <environment-id>

​
Context Graph

Neo4j-based organizational knowledge graph storing resources, relationships, and execution history.

​
Get Graph Statistics

# View overall statistics
kubiya graph stats

# Stats for specific integration
kubiya graph stats --integration github

​
List Nodes

# List all nodes
kubiya graph nodes list

# Filter by label
kubiya graph nodes list --label Agent
kubiya graph nodes list --label Team

# Limit results
kubiya graph nodes list --limit 100

​
Get Node Details

# View specific node
kubiya graph nodes get <node-id>

​
Search Nodes

# Search by property
kubiya graph nodes search \
  --label Agent \
  --property-name name \
  --property-value "deploy"

​
List Integrations

# List all integrated data sources
kubiya graph integrations list

​
Execute Custom Query

Run custom Cypher queries to analyze your organizational knowledge graph: 
# Run Cypher query
kubiya graph query --query "MATCH (n:Agent) RETURN n LIMIT 10"

# Find agents with specific skill
kubiya graph query --query "MATCH (a:Agent)-[:HAS_SKILL]->(s:Skill) WHERE s.name = 'kubernetes' RETURN a.name"

# Analyze team composition
kubiya graph query --query "MATCH (t:Team)-[:HAS_MEMBER]->(a:Agent) RETURN t.name, count(a) as member_count"

​
List Labels

# List all node labels
kubiya graph labels

​
List Relationship Types

# List all relationship types
kubiya graph relationship-types

​
Get Subgraph

# Get subgraph around node
kubiya graph subgraph --node-id <node-id> --depth 2

​
Best Practices

  • Separate environments by stage (dev, staging, production)
  • Never store sensitive data in plain text - always use secrets
  • Version control environment definitions
  • Rotate secrets regularly with automated processes
  • Use graph queries for resource discovery and pattern analysis
  • Monitor agent activity and execution success rates
  • Optimize graph queries with indexes and limits
  • Archive old execution data periodically
  • Encrypt secrets at rest
  • Enable and review audit logs
  • Implement regular Neo4j backups

​
Command Reference

# Environments
kubiya environment list [--output json|yaml]
kubiya environment get <id>
kubiya environment create --file env.yaml
kubiya environment update <id> --file env.yaml
kubiya environment delete <id>

# Context Graph - Statistics
kubiya graph stats [--integration <name>]

# Context Graph - Nodes
kubiya graph nodes list [--label <type>] [--limit <n>]
kubiya graph nodes get <id>
kubiya graph nodes search --label <type> --property-name <key> --property-value <val>

# Context Graph - Integrations
kubiya graph integrations list

# Context Graph - Custom Queries
kubiya graph query --query "<cypher>"

# Context Graph - Schema
kubiya graph labels
kubiya graph relationship-types

# Context Graph - Subgraph
kubiya graph subgraph --node-id <id> --depth <n>

​
Next Steps

Core Resources

Create agents and teams in environments

Execution Resources

Run tasks across your infrastructure

Capabilities

Configure skills and policies

Worker Management

Deploy and manage workers