Orion Code

Multi-Agent Code Orchestration - Intelligent AI Agent Coordination

Features • Installation • Quick Start • Architecture • Commands • Contributing • License

Overview

Orion Code is a multi-agent orchestration system that acts as a virtual Tech Lead, coordinating specialized AI agents to collaborate on software projects. It provides an interactive TUI (Terminal User Interface) for seamless interaction, with a REST API backend and a modern landing page.

Features

Interactive TUI - Beautiful terminal interface with Ink 5/React 18
Mouse Wheel Scroll - Scroll message history with mouse wheel or Page Up/Down
Multi-Agent Orchestration - AI-powered task orchestration via Ollama (free, local)
Inline Bash Mode - Execute shell commands directly from TUI with ! prefix
DDD Architecture - Clean, maintainable codebase with Domain-Driven Design
REST API Backend - Fastify 5-based backend with JWT + API Key authentication
Persistent Login - Tokens persist on device until explicit logout
PostgreSQL Database - Full persistence with Drizzle ORM
Intelligent Orchestration - AI-powered task planning and implementation via /implement
Natural Language Input - Type natural language to create and execute tasks
Interactive Selection Menus - Arrow-key navigation for commands
Landing Page - Modern React landing page with Tailwind CSS
Docker Support - Containerized deployment with docker-compose

Installation

Prerequisites

Node.js >= 18.0.0
npm >= 10.0.0
PostgreSQL (for production)

From Source

# Clone the repository
git clone https://github.com/vinnytherobot/orion-code.git
cd orion-code

# Install dependencies
npm install

# Build all packages
npm run build

# Start development servers
npm run dev

Environment Setup

Copy .env.example to .env and configure:

cp .env.example .env

Required variables:

DATABASE_URL - PostgreSQL connection string (defaults shown match docker-compose.yml: postgresql://orion:orion@localhost:5432/orion)
JWT_SECRET - Secret key for JWT tokens (generate one, e.g. openssl rand -hex 32)
ORION_API_URL - Backend API URL (default: http://localhost:3000)

Optional LLM provider variables (default is local Ollama):

ORION_PROVIDER - ollama | openai | anthropic | groq (default: ollama)
ORION_OLLAMA_BASE_URL - Ollama endpoint (default: http://127.0.0.1:11434)
ORION_PROVIDER_API_KEY - API key for cloud providers; ignored by Ollama
ORION_<NAME>_API_KEY / ORION_<NAME>_BASE_URL / ORION_<NAME>_MODEL - per-provider overrides

Docker: docker compose up -d starts Postgres and the API. The API runs migrations on startup and resolves the LLM provider from environment variables, so no plaintext config file is written inside the container. Ollama is not containerized — it is expected to run on the host (http://127.0.0.1:11434) and the API connects to it via ORION_OLLAMA_BASE_URL.

Quick Start

Start All Services

# Start all development servers
npm run dev

Start Individual Services

# Start the TUI
npm run dev:tui

# Start the backend API
npm run dev:backend

# Start the landing page
npm run dev:landing

Architecture

Monorepo Structure

orion-code/
├── apps/
│   ├── backend/          # Fastify API server
│   ├── tui/              # TUI interface (Ink/React)
│   └── landing/          # Landing page (React + Vite + Tailwind)
├── packages/
│   ├── shared/           # Shared utilities (Result, AppError, Logger, Config)
│   ├── domain/           # Domain entities (Agent, Task, Project)
│   ├── application/      # Use cases (AnalyzeProject, Plan, Implement)
│   └── infrastructure/   # Database, providers, cache, orchestration
├── docs/                 # Documentation and specs
└── .github/              # GitHub templates

DDD Layers

┌─────────────────────────────────────┐
│           Presentation (TUI/API)    │
├─────────────────────────────────────┤
│         Application Layer           │
│         (Use Cases, DTOs)           │
├─────────────────────────────────────┤
│           Domain Layer              │
│    (Entities, Value Objects)        │
├─────────────────────────────────────┤
│       Infrastructure Layer          │
│   (Database, Providers, Cache)      │
└─────────────────────────────────────┘

Package Dependencies

shared (zero deps)
    ↑
domain (depends on shared)
    ↑
application (depends on domain + shared)
    ↑
infrastructure (depends on domain + shared)
    ↑
apps (depends on application + infrastructure)

Agent Types

Agent	Responsibility
Planner	Task planning and decomposition
Architect	Architecture decisions
Backend	Business logic implementation
Database	Data persistence
Frontend	UI implementation
Documentation	Docs generation
QA	Test creation
Reviewer	Code review
DevOps	Infrastructure
Security	Security analysis
Performance	Optimization
Git	Version control

Commands

Authentication

Command	Description
`/register <name> <email> <password>`	Register a new user
`/login <email> <password>`	Login to the API
`/logout`	Logout and remove saved credentials
`/me`	Show current user info

Project Management

Command	Description
`/projects`	List all projects
`/create-project <name> <path> [description]`	Create a new project
`/project [id]`	Show project details
`/delete-project [id]`	Delete a project

Task Management

Command	Description
`/tasks [status]`	List active tasks
`/create-task [projectId] <title> [description]`	Create a new task
`/delete-task [taskId]`	Delete a task
`/task-stats [projectId]`	Show task statistics

Agent Management

Command	Description
`/agents [role]`	List all available agents
`/init [projectId]`	Initialize agents for a project
`/assign [agentId] [taskId]`	Assign a task to an agent
`/complete [agentId] [result]`	Mark task as completed
`/reset-agent [agentId]`	Reset agent to idle state

Orchestration

Command	Description
`/implement [projectId] [taskType]`	Implement a task using AI agents
`/orchestrate [projectId]`	Execute orchestration for pending tasks

System

Command	Description
`/help`	Show available commands
`/status`	Show API status and active agents
`/api-keys [list\|create\|delete]`	Manage API keys
`/config [key] [value]`	Show or update configuration
`/version`	Show Orion Code version
`/clear`	Clear screen
`/exit`	Exit TUI

Bash Mode

Command	Description
`!<command>`	Execute shell command directly from TUI
`!` (toggle)	Toggle bash mode on/off

Development

Setup

# Clone and install
git clone https://github.com/vinnytherobot/orion-code.git
cd orion-code
npm install

# Build
npm run build

# Development mode
npm run dev

Available Scripts

Script	Description
`npm run build`	Build all packages
`npm run dev`	Watch mode for all packages
`npm run dev:tui`	Watch TUI only
`npm run dev:backend`	Watch backend only
`npm run dev:landing`	Watch landing page only
`npm run lint`	Run Biome linter
`npm run lint:fix`	Fix lint issues
`npm run format`	Format code with Biome
`npm run check`	Run Biome check (lint + format)
`npm run check:fix`	Fix all Biome issues
`npm run typecheck`	Type checking
`npm run test`	Run tests
`npm run clean`	Clean build artifacts
`npm run db:migrate`	Run database migrations
`npm run db:generate`	Generate database migrations
`npm run docker:up`	Start Docker containers
`npm run docker:down`	Stop Docker containers

Database

The project uses PostgreSQL with Drizzle ORM:

# Run migrations
npm run db:migrate

# Generate new migration
npm run db:generate

Docker

# Start all services
npm run docker:up

# Stop all services
npm run docker:down

# Rebuild and start
npm run docker:build

Tech Stack

Backend

Runtime: Node.js + TypeScript
Framework: Fastify 5
Database: PostgreSQL 16 + Drizzle ORM
Auth: JWT + API Key with persistent tokens

Frontend (TUI)

UI Framework: Ink 5 + React 18
Language: TypeScript

Landing Page

Framework: React + Vite
Styling: Tailwind CSS
UI Components: Radix UI
Animations: Framer Motion

Infrastructure

Monorepo: npm workspaces + Turborepo
Linter/Formatter: Biome
Containerization: Docker + docker-compose

LLM Providers

Ollama (local inference, free)
OpenAI (GPT-4, GPT-4o, etc.)
Anthropic (Claude)
Groq (fast inference)

Contributing

We welcome contributions! Please see our Contributing Guide for details.

Ways to Contribute

Report bugs
Suggest features
Submit pull requests
Improve documentation
Share feedback

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

Ink - React for TUI
Fastify - Backend framework
Drizzle ORM - Database ORM
Turborepo - Monorepo tooling
Biome - Linter and formatter
Vite - Build tool for landing page
Tailwind CSS - Utility-first CSS
Radix UI - UI components
Framer Motion - Animations

Made with ❤️ by vinnytherobot and the Orion Code Community

Name		Name	Last commit message	Last commit date
Latest commit History 139 Commits
.github		.github
apps		apps
packages		packages
.dockerignore		.dockerignore
.env.example		.env.example
.gitignore		.gitignore
AGENTS.md		AGENTS.md
CHANGELOG.md		CHANGELOG.md
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
Dockerfile		Dockerfile
LICENSE		LICENSE
PROJECT.md		PROJECT.md
README.md		README.md
TODO.md		TODO.md
biome.json		biome.json
docker-compose.yml		docker-compose.yml
logo.svg		logo.svg
package-lock.json		package-lock.json
package.json		package.json
tsconfig.base.json		tsconfig.base.json
turbo.json		turbo.json

Folders and files

Latest commit

History

Repository files navigation

Orion Code

Overview

Features

Installation

Prerequisites

From Source

Environment Setup

Quick Start

Start All Services

Start Individual Services

Architecture

Monorepo Structure

DDD Layers

Package Dependencies

Agent Types

Commands

Authentication

Project Management

Task Management

Agent Management

Orchestration

System

Bash Mode

Development

Setup

Available Scripts

Database

Docker

Tech Stack

Backend

Frontend (TUI)

Landing Page

Infrastructure

LLM Providers

Contributing

Ways to Contribute

License

Acknowledgments

About

Topics

Resources

Code of conduct

Contributing

Stars

Watchers

Forks

Releases

Contributors

Languages