mahimpro0123/orchestra-ctl

Multi-Orchestrator AI Framework: Unified Command Center for Distributed Agent Swarms

Manage, monitor, and coordinate hundreds of AI agents across multiple orchestrators from a single terminal interface. Inspired by the need for true AI workforce orchestration, this framework turns your command line into a mission control room for distributed artificial intelligence.

---

Why This Exists

AI agents today are like isolated musicians playing in separate rooms. Each performs beautifully alone, but together they create chaos. Our framework is the conductor—giving you a unified baton to direct every AI agent, every orchestrator, and every workflow from one cockpit. No more context-switching between dashboards, no more lost agent threads, no more silent failures.

---

The Architecture

graph TB
    subgraph "Your Terminal"
        CLI[Multi-Orchestrator CLI]
        DASH[Dynamic Dashboard]
        NOTIFY[Real-Time Notifications]
    end
    
    subgraph "Orchestrator Layer"
        O1[Temine Orchestrator]
        O2[Custom Orchestrator A]
        O3[Custom Orchestrator B]
    end

subgraph "Agent Swarms" A1[Agent Group Alpha] A2[Agent Group Beta] A3[Agent Group Gamma] A4[Agent Group Delta] end

CLI -- O1 CLI -- O2 CLI -- O3

O1 -- A1 O1 -- A2 O2 -- A3 O3 -- A4

DASH -- CLI NOTIFY -- CLI

---

## Example Profile Configuration

Every orchestrator connection starts with a profile. Think of these as your diplomatic passports to different AI nations.

profiles: production-swarm: orchestrator: temine endpoint: https://temine.internal.corp apikey: ${TEMINEAPIKEY} timeout: 30s retrypolicy: exponential

research-lab: orchestrator: custom-agent-runner endpoint: ws://localhost:8765 connectiontype: websocket heartbeat: 5s

edge-cluster: orchestrator: temine endpoint: https://edge-temine.lan authentication: certificate certpath: /etc/temine/certs/client.pem

---

## Example Console Invocation

Deploy a multi-agent workflow across three orchestrators