orxhestra-code 0.0.13

AI coding agent powered by orxhestra — reads, writes, edits code and runs commands

orxhestra-code

AI coding agent for your terminal. Reads, writes, edits code and runs commands — powered by orxhestra.

Works with any LangChain-supported LLM provider.

Install

# Install with your preferred provider
uv pip install orxhestra-code[openai]       # GPT-5.4, o3, o4, etc.
uv pip install orxhestra-code[anthropic]    # Claude
uv pip install orxhestra-code[google]       # Gemini
uv pip install orxhestra-code[aws]          # Bedrock
uv pip install orxhestra-code[azure-ai]     # Azure OpenAI
uv pip install orxhestra-code[mistral]      # Mistral
uv pip install orxhestra-code[groq]         # Groq
uv pip install orxhestra-code[ollama]       # Ollama (local)
uv pip install orxhestra-code[fireworks]    # Fireworks
uv pip install orxhestra-code[together]     # Together
uv pip install orxhestra-code[cohere]       # Cohere
uv pip install orxhestra-code[deepseek]     # DeepSeek
uv pip install orxhestra-code[xai]          # xAI / Grok
uv pip install orxhestra-code[openrouter]   # OpenRouter (multi-provider)

# Or install all providers at once
uv pip install orxhestra-code[all]

Or from source:

git clone https://github.com/NicolaiLassen/orxhestra-code.git
cd orxhestra-code
uv sync

Usage

# Start with default model (Claude Sonnet)
orx-coder

# Use any LangChain provider
orx-coder --model anthropic/claude-sonnet-4-6
orx-coder --model openai/gpt-5.4
orx-coder --model google/gemini-2.5-pro
orx-coder --model mistral/mistral-large-latest
orx-coder --model groq/llama-3.3-70b-versatile
orx-coder --model ollama/qwen2.5-coder:32b
orx-coder --model deepseek/deepseek-chat
orx-coder --model xai/grok-3

# Control LLM reasoning effort (maps to provider-native params)
orx-coder --effort low      # fast responses, 5 iterations max
orx-coder --effort medium   # balanced reasoning, 15 iterations max
orx-coder --effort high     # deep reasoning, 30 iterations max (default)

# Effort maps to each provider's native reasoning API:
#   Anthropic  → thinking.budget_tokens
#   OpenAI     → reasoning.effort
#   Google     → thinking_level
#   xAI        → reasoning_effort
#   DeepSeek   → reasoning_effort

# Set max tokens per response
orx-coder --max-tokens 32768

# Work in a specific directory
orx-coder --workspace /path/to/project

# Pipe a command
echo "fix the failing tests" | orx-coder

What it can do

• Read files, search with glob/grep
• Write and edit files (sends diffs, not full rewrites)
• Run shell commands (build, test, git, etc.)
• Remember things across sessions (project context, preferences)
• Track tasks with a structured todo list
• Git workflow (commit, branch, PR creation)

Configuration

Create ~/.orx-coder/config.yaml for persistent defaults:

model: anthropic/claude-sonnet-4-6
effort: high
max_tokens: 16384
auto_approve_reads: true

Environment variables

Variable	Description
ORX_MODEL	Override model (e.g. openai/gpt-5.4)
ORX_EFFORT	Override effort (low, medium, high)
ANTHROPIC_API_KEY	Anthropic API key
OPENAI_API_KEY	OpenAI API key
GOOGLE_API_KEY	Google AI API key
GROQ_API_KEY	Groq API key
MISTRAL_API_KEY	Mistral API key
TOGETHER_API_KEY	Together API key
FIREWORKS_API_KEY	Fireworks API key

Project instructions

Create a CLAUDE.md (or .orx/instructions.md) in your project root with project-specific instructions. The agent loads these automatically.

# Project rules

- Use pytest for testing
- Follow PEP 8
- Always run tests before committing

Instructions are loaded from the current directory up to the filesystem root, so you can have global instructions in ~/CLAUDE.md and project-specific ones in your repo.

REPL commands

Command	Description
/model <name>	Switch model
/clear	Clear conversation
/compact	Summarize history to free context
/todos	Show task list
/memory	Browse saved memories
/help	Show all commands
/exit	Quit

License

Apache-2.0