Orion 🌌

Orion is an enterprise-grade, autonomous AI coding assistant running directly in your terminal. Designed as a fast, highly interactive alternative to other CLI agents (such as claude-code), Orion utilizes a dual-engine architecture: a high-fidelity TypeScript/React (Ink) terminal user interface combined with an enterprise-grade agentic SDK/core written in Go and compiled to WebAssembly (orion.wasm). This brings together the safety, speed, and concurrency of Go with a state-of-the-art interactive TUI.

🚀 Features

Orion isn't just a CLI; it's a locally-hosted Swarm Intelligence platform.

• Multi-Agent Orchestration (Swarm): Give Orion a complex, multi-step goal. The Go core designs an execution plan, spawns specialized goroutines acting as sub-agents, delegates tasks concurrently, and aggregates their findings.
• Infinite Sliding Window Memory: Uses tiktoken-go inside the WASM core for exact token counting and dynamically compresses/summarizes older conversation histories securely into your system prompt without severing critical tool-call schemas.
• Enterprise-Grade Security: Natively integrates with your OS-level Keychain (Apple Keychain, Windows Credential Manager, Linux Secret Service via the Go core) to retrieve credentials securely.
• Model Context Protocol (MCP): Full support for external MCP tools with native OAuth, Service Account Impersonation, and robust Token Management.
• Hierarchical Project Management: Configure Skills, Prompts, and MCP servers globally (~/.orion) or lock them strictly to a specific project workspace (.orion). Includes a Workspace Trust model to prevent prompt injection from malicious repos.
• Beautiful Interactive TUI: Built using React and Ink, providing a gorgeous stateful loop in your terminal, rich markdown rendering, themes, and dynamic <Tab> auto-completion.

📦 Installation & Setup

Orion runs using Node.js v18+ and Go v1.26+. You simply bring your own API key (Anthropic Claude, OpenAI, or custom OpenAI-compatible endpoints).

Build from Source

To clone and compile Orion:

git clone https://github.com/orion-ai/orion
cd orion

You can use the provided Makefile to build and test:

# Compile Go SDK to WebAssembly and run the CLI in development mode
make run

# Run Go and TypeScript unit tests
make test

Alternatively, build the production-ready distribution:

# Compile WASM and TypeScript code into the dist/ directory
cd cli && npm install && npm run build

🛠 Usage

To launch the interactive terminal interface:

# If running locally from the cloned directory
cd cli && npm start

Auto-Complete & Commands: Inside the REPL, type / and hit <Tab> to see all available slash commands. Orion supports rich auto-completion for --provider, --model, and local filesystem paths.

Example execution (headless/non-interactive):

orion -p "Refactor the authentication logic in src/ to use JWTs instead of session cookies" --provider anthropic --model claude-3-5-sonnet

🛡 Configuration & Keys

On your first run, Orion will walk you through a setup wizard to select your preferred provider and input your API key. Keys are immediately encrypted and stored inside your native OS Keychain.

You can switch themes or update your provider securely at any time inside the REPL by typing /theme or /provider.

🤝 Contributing

Orion is highly extensible via its Skills Registry and Extensions system. If you want to build a custom skill, simply drop a declarative .json schema inside your local .orion/skills directory, and Orion's hierarchical loader will automatically equip it. All extensions are cryptographically verified via HMAC-SHA256 signatures before execution.