CLI Commands

Command Structure

QODRYX CLI commands follow a consistent structure:

qodryx <command> [subcommand] [options] [arguments]

# Examples:
qodryx projects list
qodryx workflows create --prompt "Add auth"
qodryx security scan --type sast

Global Options

Command Categories

Authentication Commands

qodryx auth login

Authenticate with QODRYX.

# Interactive browser login
qodryx auth login

# Token-based login (for CI/CD)
qodryx auth login --token YOUR_API_KEY

# Login with specific scope
qodryx auth login --scope "read:projects,write:workflows"

qodryx auth logout

Log out and clear credentials.

qodryx auth logout

# Clear all sessions
qodryx auth logout --all

qodryx auth status

Show current authentication status.

qodryx auth status

# Output:
# ✓ Authenticated as john@example.com
# ✓ Organization: Acme Corp
# ✓ Plan: Pro

qodryx auth token

Generate or display API tokens.

# Create new token
qodryx auth token create --name "CI Token" --scope "read:*,write:workflows"

# List tokens
qodryx auth token list

# Revoke token
qodryx auth token revoke TOKEN_ID

Project Commands

qodryx projects list

List all projects.

qodryx projects list

# Filter by organization
qodryx projects list --org org_abc123

# Output as JSON
qodryx projects list -o json

qodryx projects create

Create a new project.

qodryx projects create --name "my-app" --repo github.com/user/my-app

# With description
qodryx projects create \
  --name "my-app" \
  --repo github.com/user/my-app \
  --description "My awesome application"

qodryx projects get

Get project details.

qodryx projects get proj_abc123

# Or use current directory's project
qodryx projects get

qodryx projects delete

Delete a project.

qodryx projects delete proj_abc123

# Skip confirmation
qodryx projects delete proj_abc123 --force

qodryx projects init

Initialize QODRYX in current directory.

# Interactive setup
qodryx projects init

# Link to existing project
qodryx projects init --project proj_abc123

# Create new project from current repo
qodryx projects init --create

Workflow Commands

qodryx workflows create

Create and trigger a new workflow.

# Create workflow with prompt
qodryx workflows create --prompt "Add user authentication with OAuth"

# Specify project
qodryx workflows create -p proj_abc123 --prompt "Fix the login bug"

# With specific AI provider
qodryx workflows create --prompt "Add tests" --ai-provider anthropic

# Skip auto-deploy
qodryx workflows create --prompt "Add feature" --no-deploy

qodryx workflows list

List workflows.

qodryx workflows list

# Filter by status
qodryx workflows list --status running

# Show last N workflows
qodryx workflows list --limit 10

qodryx workflows get

Get workflow details and status.

qodryx workflows get wf_xyz789

# Watch status in real-time
qodryx workflows get wf_xyz789 --watch

qodryx workflows logs

View workflow logs.

# All logs
qodryx workflows logs wf_xyz789

# Specific stage
qodryx workflows logs wf_xyz789 --stage build

# Stream logs in real-time
qodryx workflows logs wf_xyz789 --follow

qodryx workflows cancel

Cancel a running workflow.

qodryx workflows cancel wf_xyz789

qodryx workflows retry

Retry a failed workflow.

qodryx workflows retry wf_xyz789

# Retry from specific stage
qodryx workflows retry wf_xyz789 --from-stage verify

Security Commands

qodryx security scan

Run security scans.

# Run all scan types
qodryx security scan

# Specific scan types
qodryx security scan --type sast
qodryx security scan --type secrets
qodryx security scan --type dependencies

# Multiple types
qodryx security scan --type sast,secrets

# Scan specific branch
qodryx security scan --branch feature/auth

# Scan specific path
qodryx security scan --path ./src

qodryx security results

View scan results.

# Latest scan results
qodryx security results

# Specific scan
qodryx security results scan_abc123

# Filter by severity
qodryx security results --severity critical,high

# Output as JSON for CI
qodryx security results -o json --severity critical

qodryx security fix

Auto-remediate vulnerabilities.

# Fix specific finding
qodryx security fix finding_abc123

# Fix all critical findings
qodryx security fix --severity critical

# Preview fixes without applying
qodryx security fix --dry-run

qodryx security ignore

Ignore findings.

# Ignore specific finding
qodryx security ignore finding_abc123 --reason "False positive"

# Ignore by rule
qodryx security ignore --rule SQL_INJECTION --path "./tests/**"

Deployment Commands

qodryx deploy

Deploy your application.

# Deploy to default environment
qodryx deploy

# Deploy to specific environment
qodryx deploy --env production

# Deploy specific branch
qodryx deploy --branch main

# Deploy to specific provider
qodryx deploy --provider vercel

# Deploy with message
qodryx deploy --message "Release v1.2.0"

qodryx deploy status

Check deployment status.

qodryx deploy status

# Specific deployment
qodryx deploy status deploy_abc123

# Watch in real-time
qodryx deploy status --watch

qodryx deploy logs

View deployment logs.

qodryx deploy logs deploy_abc123

# Follow logs
qodryx deploy logs deploy_abc123 --follow

qodryx deploy rollback

Rollback a deployment.

# Rollback to previous
qodryx deploy rollback

# Rollback to specific deployment
qodryx deploy rollback --to deploy_xyz789

# Rollback production
qodryx deploy rollback --env production

qodryx deploy list

List deployments.

qodryx deploy list

# Filter by environment
qodryx deploy list --env production

# Show last N
qodryx deploy list --limit 20

Test Commands

qodryx tests generate

Generate tests using AI.

# Generate tests for specific file
qodryx tests generate ./src/auth/login.ts

# Generate for all changed files
qodryx tests generate --changed

# Specify test framework
qodryx tests generate ./src --framework jest

qodryx tests run

Run tests.

# Run all tests
qodryx tests run

# Run specific file
qodryx tests run ./src/auth/login.test.ts

# Run with coverage
qodryx tests run --coverage

qodryx tests coverage

View test coverage report.

qodryx tests coverage

# Open in browser
qodryx tests coverage --open

Configuration Commands

qodryx config set

Set configuration values.

qodryx config set default_project proj_abc123
qodryx config set output json
qodryx config set editor vim

qodryx config get

Get configuration values.

qodryx config get default_project

qodryx config list

List all configuration.

qodryx config list

qodryx config reset

Reset configuration to defaults.

qodryx config reset

Utility Commands

qodryx update

Update the CLI.

# Update to latest
qodryx update

# Check for updates
qodryx update --check

qodryx completion

Generate shell completions.

qodryx completion bash
qodryx completion zsh
qodryx completion fish
qodryx completion powershell

qodryx doctor

Check CLI health and configuration.

qodryx doctor

# Output:
# ✓ CLI version: 1.0.0
# ✓ Node version: 20.0.0
# ✓ Authentication: OK
# ✓ Network: OK
# ✓ Project config: Found

Next Steps