Commands

Kodezi CLI includes multiple commands designed for development workflows, automation, debugging, configuration discovery, and authentication.

While most users spend the majority of their time in interactive mode, understanding the full command set helps unlock the CLI’s complete capabilities.

Command Overview

Below is a quick reference to all available commands.

Interactive Mode (Default)

The primary command of Kodezi CLI:

kodezi

This is the primary way to use Kodezi CLI. It starts a conversational interface where you can work naturally with AI on development tasks.

Features:

• Natural language interface
• Session persistence
• Full tool access
• Context continuity across conversations

Learn more →

Auth Command

Manage authentication credentials:

# Interactive login with email and token
kodezi auth login

# Check authentication status
kodezi auth status

# Remove stored credentials
kodezi auth logout

Required before using other commands (except in interactive mode, which prompts for authentication).

Learn more →

Run Command (Non-Interactive Execution)

The run command lets you execute one AI task at a time, without entering interactive mode.

Useful for:

• CI/CD pipelines
• Git hooks
• Automation scripts
• One liners in the terminal

# Run a prompt from arguments
kodezi run "Explain the use of context in Go"

# Pipe input from stdin
echo "What is this code doing?" | kodezi run

# Run quietly (no spinner)
kodezi run -q "Generate a README"

Flags:

• --quiet, -q - Hide spinner output

Use cases:

• CI/CD pipelines
• Automation scripts
• Quick one-off tasks

Learn more →

Dirs Command

Shows the file paths for global config, data directory, and project config.

# Show all directories
kodezi dirs

# Show only config directory
kodezi dirs config

# Show only data directory
kodezi dirs data

Useful for troubleshooting or when you need to manually access configuration files.

Learn more →

Logs Command

Use logs to diagnose errors in:

• MCP servers
• LSP initialization
• File permission issues
• System failures
• Network errors
• Unexpected behavior

# Show last 1000 lines (default)
kodezi logs

# Follow log output in real-time
kodezi logs -f

# Show last 500 lines
kodezi logs -t 500

# Follow with custom tail
kodezi logs -f -t 100

Flags:

Learn more →

Global Flags

These global flags can be added to any Kodezi CLI command.

Working Directory

Run in a different directory:

# Run in specific directory
kodezi --cwd /path/to/project
kodezi -c /path/to/project

Custom Data Directory

Useful when isolating environments:

# Use custom data directory
kodezi --data-dir /path/to/.kodezi
kodezi -D /path/to/.kodezi

Debug Mode

Enable verbose debugging:

# Enable debug logging
kodezi --debug
kodezi -d

Shows internal logs, requests, LSP boot logs, MCP handshake logs, etc.

Yolo Mode

# Skip all permission prompts (dangerous)
kodezi --yolo
kodezi -y

Help

# Show help for any command
kodezi --help
kodezi auth --help
kodezi run --help

Shows command-specific help and usage examples.

Version

# Display version
kodezi --version
kodezi -v

Common Usage Patterns

# Authenticate
kodezi auth login

# Start interactive session
kodezi

# Start in project directory
cd /path/to/project
kodezi

# Or specify directory
kodezi -c /path/to/project

# Single task execution
kodezi run "Run tests and generate coverage report"

# Quiet mode for scripts
kodezi run -q "Format all code files"

# Auto-approve for CI/CD
kodezi run -y "Analyze code for security issues"

# View recent logs
kodezi logs

# Watch logs in real-time
kodezi logs -f

# Check authentication
kodezi auth status

# Enable debug output
kodezi -d

Next Steps

Explore each command in detail:

• Interactive Mode: Master the primary interface
• Auth: Authentication setup
• Run: Automation patterns
• Dirs: Configuration locations
• Logs: Activity tracking

Or explore related topics:

• Configuration: Customize behavior