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
  • 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 Your Profile

Set up a profile for your Kodexa environment: 
kdx config set-profile local \
  --url http://localhost:8080 \
  --api-key your-api-key-here
For production: 
kdx config set-profile prod \
  --url https://platform.kodexa.ai \
  --api-key your-production-api-key

​
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.