Installation

# Add the Kodexa tap
brew tap kodexa-ai/tap

# Install kdx
brew install kdx

# Verify installation
kdx --version

# Update kdx to the latest version
brew upgrade kdx

# Install the pre-release CLI
brew install kodexa-ai/tap/kdx-dev

# Verify installation
kdx-dev --version

# Update to latest dev build
brew upgrade kdx-dev

# Add the Kodexa bucket
scoop bucket add kodexa https://github.com/kodexa-ai/scoop-bucket

# Install kdx
scoop install kdx

# Verify installation
kdx --version

# Update kdx to the latest version
scoop update kdx

# Install the pre-release CLI
scoop install kdx-dev

# Verify installation
kdx-dev --version

# Update to latest dev build
scoop update kdx-dev

# Pull the latest image
docker pull kodexa/kdx:latest

# Run kdx commands
docker run --rm kodexa/kdx:latest --version

# Mount local files for metadata and document operations
docker run --rm -v $(pwd):/workspace kodexa/kdx:latest get activity-plans

# Create an alias for convenience
alias kdx='docker run --rm -v $(pwd):/workspace -v ~/.kodexa:/root/.kodexa kodexa/kdx:latest'

# Get the latest version and download the .deb package
VERSION=$(curl -s https://api.github.com/repos/kodexa-ai/kdx-cli/releases/latest | grep '"tag_name"' | sed 's/.*"v\(.*\)".*/\1/')
wget "https://github.com/kodexa-ai/kdx-cli/releases/download/v${VERSION}/kdx_${VERSION}_linux_amd64.deb"

# Install with dpkg
sudo dpkg -i "kdx_${VERSION}_linux_amd64.deb"

# Verify installation
kdx --version

# Get the latest version and download the .rpm package
VERSION=$(curl -s https://api.github.com/repos/kodexa-ai/kdx-cli/releases/latest | grep '"tag_name"' | sed 's/.*"v\(.*\)".*/\1/')
wget "https://github.com/kodexa-ai/kdx-cli/releases/download/v${VERSION}/kdx_${VERSION}_linux_amd64.rpm"

# Install with rpm
sudo rpm -i "kdx_${VERSION}_linux_amd64.rpm"

# Verify installation
kdx --version

VERSION=$(curl -s https://api.github.com/repos/kodexa-ai/kdx-cli/releases/latest | grep '"tag_name"' | sed 's/.*"v\(.*\)".*/\1/')
curl -L "https://github.com/kodexa-ai/kdx-cli/releases/download/v${VERSION}/kdx_${VERSION}_linux_x86_64.tar.gz" | tar xz
sudo mv kdx /usr/local/bin/
kdx --version

VERSION=$(curl -s https://api.github.com/repos/kodexa-ai/kdx-cli/releases/latest | grep '"tag_name"' | sed 's/.*"v\(.*\)".*/\1/')
curl -L "https://github.com/kodexa-ai/kdx-cli/releases/download/v${VERSION}/kdx_${VERSION}_darwin_x86_64.tar.gz" | tar xz
sudo mv kdx /usr/local/bin/
kdx --version

VERSION=$(curl -s https://api.github.com/repos/kodexa-ai/kdx-cli/releases/latest | grep '"tag_name"' | sed 's/.*"v\(.*\)".*/\1/')
curl -L "https://github.com/kodexa-ai/kdx-cli/releases/download/v${VERSION}/kdx_${VERSION}_darwin_arm64.tar.gz" | tar xz
sudo mv kdx /usr/local/bin/
kdx --version

# Get the latest version, download and extract
$release = Invoke-RestMethod -Uri "https://api.github.com/repos/kodexa-ai/kdx-cli/releases/latest"
$version = $release.tag_name -replace '^v', ''
Invoke-WebRequest -Uri "https://github.com/kodexa-ai/kdx-cli/releases/download/v${version}/kdx_${version}_windows_x86_64.zip" -OutFile kdx.zip
Expand-Archive kdx.zip -DestinationPath .

# Move to a directory in your PATH
Move-Item kdx.exe C:\Windows\System32\

# Verify installation
kdx --version

go install github.com/kodexa-ai/kdx-cli/cmd/kdx@latest
kdx --version

# Clone the repository
git clone https://github.com/kodexa-ai/kdx-cli
cd kdx-cli

# Build for your platform
make build

# Or install directly to $GOPATH/bin
make install

# Verify installation
kdx --version

# Check version
kdx --version

# View available commands
kdx --help

# Test connection (requires profile setup)
kdx config current-profile

# Generate completion script
kdx completion bash > /usr/local/etc/bash_completion.d/kdx

# Or add to your .bashrc
echo 'source <(kdx completion bash)' >> ~/.bashrc
source ~/.bashrc

# Generate completion script
kdx completion zsh > "${fpath[1]}/_kdx"

# Or add to your .zshrc
echo 'source <(kdx completion zsh)' >> ~/.zshrc
source ~/.zshrc

kdx completion fish > ~/.config/fish/completions/kdx.fish

kdx completion powershell | Out-String | Invoke-Expression

# Add to your profile for persistence
kdx completion powershell >> $PROFILE

# Homebrew
brew upgrade kdx

# Scoop
scoop update kdx

# Pre-release builds
brew upgrade kdx-dev    # macOS/Linux
scoop update kdx-dev    # Windows

# Backup current version
sudo mv /usr/local/bin/kdx /usr/local/bin/kdx.backup

# Download and install the latest version
VERSION=$(curl -s https://api.github.com/repos/kodexa-ai/kdx-cli/releases/latest | grep '"tag_name"' | sed 's/.*"v\(.*\)".*/\1/')
curl -L "https://github.com/kodexa-ai/kdx-cli/releases/download/v${VERSION}/kdx_${VERSION}_linux_x86_64.tar.gz" | tar xz
sudo mv kdx /usr/local/bin/

# Verify new version
kdx --version

# Check if kdx is in your PATH
which kdx

# If not found, add the installation directory to PATH
export PATH="/usr/local/bin:$PATH"

# Make permanent by adding to shell profile
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bashrc  # or ~/.zshrc

chmod +x /usr/local/bin/kdx

rm -rf ~/.kodexa/cache/
kdx api-resources --refresh