LLM-powered deployment troubleshooting assistant for Orca
npm install orca-deploy-assistantLLM-powered deployment troubleshooting assistant for Orca.
``bashInstall globally
npm install -g orca-deploy-assistant
$3
`bash
npx orca-deploy-assistant
`$3
`bash
Install dependencies
npm installBuild
npm run buildRun
npm start
`Usage
`bash
Interactive mode (default)
orca-deploy-assistantSingle query
orca-deploy-assistant "Why is the backend restarting?"Force interactive mode
orca-deploy-assistant --interactiveConfigure credentials
orca-deploy-assistant --loginSpecify 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+CConfiguration
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 installBuild TypeScript
npm run buildRun 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 pathMIT