Orca Deployment Assistant (TypeScript CLI)

LLM-powered deployment troubleshooting assistant for Orca.

Installation

$3

``bash


Install globally

npm install -g orca-deploy-assistant

Run

orca-deploy-assistant
`

$3

`bash
npx orca-deploy-assistant
`

$3

`bash


Install dependencies

npm install

Build

npm run build

Run

npm start
`

Usage

`bash


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

`bash


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