Orca Deployment Assistant (TypeScript CLI)

LLM-powered deployment troubleshooting assistant for Orca.

Installation

Global Install

# Install globally
npm install -g orca-deploy-assistant

# Run
orca-deploy-assistant

Using npx

npx orca-deploy-assistant

Local Development

# Install dependencies
npm install

# Build
npm run build

# Run
npm start

Usage

# Interactive mode (default)
orca-deploy-assistant

# Single query
orca-deploy-assistant "Why is the backend restarting?"

# Force interactive mode
orca-deploy-assistant --interactive

# Configure credentials
orca-deploy-assistant --login

# Specify deployment directory
orca-deploy-assistant -d /path/to/deployment

Commands (Interactive Mode)

| Command | Description | |---------|-------------| | /login | Configure LLM provider credentials | | /settings | Show current settings (secrets masked) | | /models | List available models | | /model | Change model for current provider | | /provider <name> | Switch provider (anthropic, openai, azure) | | /clear | Clear conversation history | | /help | Show available commands | | quit, exit | Exit the assistant |

Supported Providers

• Anthropic (Claude) - Default
• OpenAI (GPT)
• Azure OpenAI

Features

• Multi-provider support with easy switching
• Streaming responses
• Tool use for deployment inspection:
  • run_command - Execute shell commands
  • read_file - Read configuration files
  • list_directory - List directory contents
  • inspect_env - View .env with secrets redacted
  • query_database - Read-only SQLite queries
  • search_logs - Search container logs
  • check_container_health - Container health reports
• Settings persistence (~/.deployment_assistant.json)
• Cancellation with 'q' or Ctrl+C

Configuration

Settings are stored in .deployment_assistant.json in the deployment directory. The file is automatically created on first run and contains:

• Provider selection
• API keys (stored locally)
• Model preferences

Development

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run development
npm run dev

Requirements

• Node.js 18+
• Docker (for container inspection tools)
• SQLite (via better-sqlite3)

Environment Variables

• DEPLOYMENT_DIR - Override the deployment directory path

License

MIT