Skip to content

ShalevAri/orchestrator

Repository files navigation

Orchestrator

Warning

Orchestrator is currently in hiatus as I'm busy with some other projects. This does not mean the project is abandoned. Once I'm done I'll continue updating this, already got a few changes in mind.

An AI agent orchestration system for OpenCode that delegates tasks to specialized subagents for optimal results while maintaining cost-efficiency.

Architecture

Orchestrator (Primary Agent)

The main agent you interact with. Provide high-level requirements and the Orchestrator will:

  • Analyze your request
  • Create clear execution plans
  • Delegate work to appropriate specialized subagents
  • Coordinate task execution and track progress

Specialized Subagents

Domain-specific subagents that execute focused work based on the Orchestrator's instructions.
Each subagent is optimized for a particular type of task, ensuring high-quality results.

Key Features

  • Cost-Effective Quality: Achieves excellent results by having larger models guide smaller ones
  • Intelligent Task Delegation: Automatically breaks down complex tasks into focused subtasks and assigns them to appropriate subagents
  • Pre-Configured Subagents: Includes multiple specialized subagents for various development tasks
  • Future-Proof: Built specifically for OpenCode to be as open, accessible and future-proof as possible

Quality Assurance

Agents are manually tested and refined for reliable performance.
Each agent is paired with models optimized for their domain, balancing quality and cost-efficiency.

Getting Started

Prerequisites

Installation

Warning

Installing/updating the Orchestrator script will override your existing .opencode directory and opencode.json file.

Note

It's a good practice to verify scripts before running them

curl -fsSL https://raw.githubusercontent.com/ShalevAri/orchestrator/main/orchestrator.sh -o orchestrator.sh
chmod +x orchestrator.sh
./orchestrator.sh
rm orchestrator.sh

The installation script will install the latest tagged release into your project's .opencode directory.

Usage

Launch OpenCode and select Orchestrator as the Primary Agent:

opencode

Provide high-level instructions to the Orchestrator. It will:

  1. Analyze your requirements
  2. Break down the work into focused subtasks
  3. Delegate tasks to appropriate subagents
  4. Coordinate execution and track progress
  5. Report results back to you

Updating

To update Orchestrator, simply re-run the installation command.

Configuration

Files in the .opencode/ directory are managed by Orchestrator and will be overwritten during updates.
Do not modify these files directly.

Instead, to customize agent behavior or configuration:

  • Project-specific settings: Use your project's opencode.json file
  • User-wide preferences: Use your global OpenCode configuration at ~/.config/opencode/

For detailed configuration options, see the OpenCode documentation.

Development & Releases

Orchestrator uses a tag-based release workflow:

  • main branch: Active development (not to be used)
  • Release tags: Stable, verified versions intended for production use

Available Agents

Orchestrator includes the following agents:

Primary

  • Orchestrator

Subagents

Core

  • Context Manager
  • Planner
  • Reviewer
  • Task Manager
  • Tester

Lang

  • React Specialist
  • Rust Developer

Specialists

  • Designer
  • Frontend Developer
  • React Native Specialist

Util

  • Commentor
  • Commit Message Generator
  • Jujutsu

License

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

About

An AI agent orchestration system

Resources

License

Contributing

Stars

Watchers

Forks

Packages

No packages published

Languages