Skip to main content
Early Access - Coming 2026The KDX CLI is currently in early access. Features and commands may change before general availability.

​
KDX CLI Quick Start

The KDX CLI (kdx) is a modern, kubectl-style command-line interface for the Kodexa AI Platform. It provides a powerful and familiar interface for managing Kodexa resources directly from the terminal.

​
Why KDX CLI?

  • Kubectl-Style Interface: Familiar commands like get, describe, create, apply, and delete
  • Dynamic Resource Discovery: Automatically discovers resources from your platform’s OpenAPI specification
  • Profile-Based Authentication: Manage multiple environments with ease
  • Production Safety: Confirmation prompts prevent accidental changes to production
  • GitOps Ready: Built-in metadata sync for version-controlled infrastructure
  • Multiple Output Formats: Interactive tables, JSON, and YAML for any workflow

​
Installation

Install the KDX CLI (installation methods coming soon): 
# Installation command will be available with the official release
# For now, contact support@kodexa.com for early access

​
Quick Start

​
1. Configure Authentication

Recommended: Environment Variables Set environment variables for your Kodexa environments: 
export KODEXA_LOCAL_KEY="your-api-key-here"
export KODEXA_PROD_KEY="your-production-api-key"
Add these to your shell profile (~/.bashrc, ~/.zshrc) to make them permanent. Legacy: Profiles (deprecated for sync operations) Alternatively, you can use profiles for backwards compatibility: 
kdx config set-profile local \
  --url http://localhost:8080 \
  --api-key your-api-key-here
For production (with safety prompts): 
kdx config set-profile prod \
  --url https://platform.kodexa.ai \
  --api-key your-production-api-key \
  --production
The --production flag enables confirmation prompts before destructive operations to prevent accidental changes.
Environment variables are the recommended approach for authentication. Profile-based authentication is maintained for backwards compatibility but deprecated for metadata sync operations.

​
2. Discover Resources

See what resources are available in your environment: 
kdx api-resources

​
3. List Resources

Use the get command to list resources: 
# List all workspaces
kdx get workspaces

# List all projects
kdx get projects

# List all stores
kdx get stores

​
4. Get Specific Resources

Retrieve details about a specific resource: 
kdx get workspace my-workspace
kdx describe workspace my-workspace

​
5. Create Resources

Create resources declaratively using YAML files:
workspace.yaml
kind: workspace
name: engineering-workspace
description: Engineering team workspace
Apply the configuration: 
kdx create workspace -f workspace.yaml

​
Working with Multiple Environments

Switch between profiles easily: 
# Switch to staging
kdx config use-profile staging

# Use production profile for a single command
kdx get workspaces --profile prod

​
Output Formats

KDX CLI supports multiple output formats: 
# Interactive table (default for terminals)
kdx get workspaces

# JSON output (great for scripting)
kdx get workspaces -o json

# YAML output
kdx get workspaces -o yaml

​
Getting Help

KDX CLI has built-in help for every command: 
# General help
kdx --help

# Command-specific help
kdx get --help
kdx config --help

​
Configuration

All KDX CLI configuration is stored in ~/.kodexa/config.yaml

​
Next Steps

Full KDX CLI Guide

Learn about all KDX CLI capabilities and features

Quick Start Guide

Comprehensive quick start with more examples

Profile Configuration

Deep dive into profile management

Resource Operations

Learn advanced CRUD operations

​
Legacy Kodexa CLI

If you’re using the older kodexa CLI (installed via pip install kodexa-cli), we recommend migrating to the new KDX CLI for improved functionality and ongoing support.
Need help migrating from the legacy CLI? Contact support@kodexa.com for guidance.