orquesta-cli

AI-powered coding assistant with local LLM support - the self-hosted alternative to Claude CLI.

Use your own LLM (vLLM, Ollama, LM Studio, Azure OpenAI, or any OpenAI-compatible API) as a full coding agent - no cloud dependency, no subscription costs.

⚠️ Security Warning

IMPORTANT: Orquesta CLI gives AI models the ability to execute commands on your system. Please read SECURITY.md before use.

Quick Security Tips:

• ✅ Use only trusted LLM endpoints
• ✅ Enable manual approval for production (autoApprove: false)
• ✅ Run in isolated environments (Docker/VM)
• ✅ Review commands before execution
• ❌ Never expose sensitive credentials as environment variables

Why orquesta-cli?

Freedom from cloud dependencies - Run your own LLM infrastructure:

| Feature | Claude CLI | orquesta-cli | |---------|-----------|--------------| | LLM Provider | Anthropic (cloud) | Any OpenAI-compatible endpoint | | Hosting | Subscription required | Self-hosted / on-premises | | Options | Claude only | vLLM, Ollama, LM Studio, Azure OpenAI, local models | | Cost | Per-token pricing | Your infrastructure | | Privacy | Data sent to Anthropic | Data stays local | | Integration | - | Works with orquesta-agent |

Key Features

| Benefit | Description | |---------|-------------| | Zero Cloud Dependency | Runs entirely on your local/on-prem LLM. Your code never leaves your network. | | No API Cost | Use open-source models (Llama, Qwen, DeepSeek, etc.) for free. | | Any OpenAI-Compatible API | Works with vLLM, Ollama, LM Studio, Azure OpenAI, Google Gemini, and more. | | Autonomous Coding Agent | Reads, searches, edits, and creates code files - not just chat. | | Plan & Execute | Breaks complex tasks into TODO steps and executes them sequentially. | | Safe by Default | Supervised mode requires your approval before any file modification. | | Office Automation | Control Excel, Word, PowerPoint directly via PowerShell/COM (Windows). | | Browser Automation | Chrome/Edge CDP control - navigate, click, screenshot, scrape data. | | orquesta-agent Compatible | Works seamlessly with orquesta-agent for remote execution |

Installation

npm install -g orquesta-cli

Or run directly with npx:

npx orquesta-cli

Quick Start

Interactive Mode

orquesta

This launches the full interactive UI with plan & execute, file browser, session history, etc.

One-Shot Prompt Execution

orquesta -p "fix the bug in auth.ts"

This executes the prompt and exits - compatible with orquesta-agent for remote execution.

Configuration

orquesta            # Setup wizard on first run
/settings           # Settings menu while running

Any OpenAI-compatible API works:

• vLLM: http://localhost:8000/v1
• Ollama: http://localhost:11434/v1
• LM Studio: http://localhost:1234/v1
• Azure OpenAI: https://YOUR_RESOURCE.openai.azure.com/openai/deployments/YOUR_DEPLOYMENT
• Google Gemini: Compatible with OpenAI SDK
• Any internal LLM server

Configuration is stored in ~/.orquesta-cli/config.json.

Usage with orquesta-agent

orquesta-cli works seamlessly with orquesta-agent for remote execution:

# On your server/VM
npm install -g orquesta-cli

# Configure your local LLM endpoint
orquesta  # Follow setup wizard

# Run orquesta-agent (it will use orquesta-cli instead of claude)
npx orquesta-agent --token <your-token>

orquesta-agent will execute prompts using orquesta-cli with your local LLM.

Commands & Features

Plan & Execute

Automatically decomposes requests into TODO steps and executes them:

You: Add a logging system to the project

TODO List                            1/3
  [x] Create logger.ts
  [ ] Add imports to existing code
  [ ] Apply error handling

Supervised Mode

Every file modification requires your explicit approval:

• Tab to toggle between Auto / Supervised mode
• Only file modification tools need approval (read/search are always allowed)
• Reject with feedback to guide the agent's next attempt

Slash Commands

| Command | Description | |---------|-------------| | /help | Show available commands | | /clear | Reset conversation | | /compact | Compress conversation | | /load | Load saved session | | /model | Switch LLM model | | /settings | Settings menu | | /usage | Token usage statistics | | /sync | Sync LLM configs with Orquesta dashboard | | /tool | Toggle optional tools (browser/office) |

Keyboard Shortcuts

| Key | Action | |-----|--------| | Ctrl+C | Exit | | ESC | Interrupt current task | | Tab | Toggle Auto / Supervised | | @ | File browser | | / | Command autocomplete |

Command-Line Options

orquesta [options]

Options:
  -p, --print <prompt>           Execute a prompt and exit (non-interactive)
  --token <token>                Connect to Orquesta with CLI token (oclt_xxx)
  --switch-project [projectId]   Switch to different project
  --status                       Show Orquesta connection status
  --disconnect                   Disconnect from Orquesta
  --sync                         Sync LLM configs with dashboard
  --dangerously-skip-permissions Skip all permission prompts (auto-approve)
  --verbose                      Enable verbose logging
  --debug                        Enable debug logging
  --llm-log                      Log LLM requests/responses
  --eval                         Evaluation mode (NDJSON event streaming)
  -V, --version                  Output version number

Orquesta Dashboard Integration

Connect to Orquesta to sync LLM configurations across your team:

# First time: Connect with token (get from https://orquesta.live/dashboard/orquesta-cli)
orquesta --token oclt_xxxxx

# You'll see a project selector - choose your project
# LLM endpoints will auto-sync from dashboard

# Later: Switch to different project
orquesta --switch-project

# Check connection status
orquesta --status

# Manual sync (also available via /sync command while running)
orquesta --sync

Office Automation (60+ Tools)

Windows only - Control Microsoft Office via PowerShell/COM:

| App | Capabilities | |-----|-------------| | Excel | Read/write cells, create charts, formatting, conditional formatting, pivot tables, formulas | | Word | Write text, headers, tables, images, footnotes, find/replace, styles, TOC | | PowerPoint | Create slides, add text/images/shapes, apply themes, speaker notes |

Browser Automation

Chrome/Edge automation via Chrome DevTools Protocol:

• Navigate pages, click elements, fill forms
• Take screenshots, extract text
• No external server required

Session Management

• Save and restore conversation history
• Auto-context compression at 80% capacity
• Resume work exactly where you left off

Development

# Clone the repository
git clone https://github.com/orquesta/orquesta.git
cd orquesta/packages/orquesta-cli

# Install dependencies
npm install

# Build
npm run build

# Run locally
npm start
# Or: node dist/cli.js

Requirements

• Node.js v20+
• npm v10+
• Git
• Windows (for Office/Browser automation via PowerShell)

Comparison with Claude CLI

Both tools are AI-powered coding assistants but differ in architecture:

Claude CLI (Official)

• ✅ Direct Anthropic API access
• ✅ Claude 4.5/4.6 models
• ✅ Official support
• ❌ Requires subscription
• ❌ Cloud-only
• ❌ Data sent to Anthropic

orquesta-cli

• ✅ Self-hosted LLM support
• ✅ Any OpenAI-compatible model
• ✅ Full data privacy
• ✅ No subscription needed (BYO compute)
• ✅ Plan & Execute architecture
• ✅ Office/Browser automation
• ❌ Model quality depends on your LLM choice

Use Claude CLI if: You want the best model quality and have a subscription.

Use orquesta-cli if: You need data privacy, self-hosting, or want to use specific models (local, on-prem, etc.).

License

MIT

Links

• Dashboard: https://orquesta.live
• GitHub: https://github.com/orquesta/orquesta
• npm: https://www.npmjs.com/package/orquesta-cli