Skip to content

About

Universal AI Harness Administration & Control Plane for Claude Code, Codex, Grok, Antigravity, Freebuff, Copilot CLI, Hermes, OpenCode & Kilo

Topics

Resources

Security policy

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

282 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OrquestraAI

Universal AI Harness Administration & Control Plane

License: MIT Status: Alpha Platform

Read in Portuguese / Leia em Português (README.pt-BR.md)


Warning

Alpha software — expect breaking changes. OrquestraAI is in active Alpha: schemas, IPC commands, and config formats can change between alpha revisions, so pin automated setups to a tagged release. The core modules (harness bridge, skills vault, session telemetry, MCP management) are covered by automated unit, contract, and integration tests and are suitable for daily local workflows.


⚡ Quick Install

curl -fsSL https://orquestra.internetdozero.com.br/install.sh | bash

If an installed Linux build does not launch, check its shared-library dependencies without reinstalling:

curl -fsSL https://orquestra.internetdozero.com.br/install.sh | sh -s -- --check-deps

🌟 What is OrquestraAI?

Modern AI engineering often involves using multiple AI coding agents and CLI harnesses concurrently: Claude Code, OpenAI Codex, xAI Grok, Antigravity (AGY), Freebuff / Manicode, GitHub Copilot CLI, Hermes Agent, OpenCode, and Kilo Code.

However, each tool maintains its own isolated skill definitions, separate MCP server configurations, fragmented system instructions (AGENTS.md vs CLAUDE.md), and scattered session histories.

OrquestraAI solves this fragmentation with a high-performance Tauri v2 + Rust + React desktop application and headless CLI. It provides:

  1. Universal Skills Vault & Projections: Maintain one central skills repository (~/.orquestra/skills-library) and project skills dynamically (via symlinks or native JSONC config injection) into any harness with zero disk duplication.
  2. Official Extensions & Community Hub: 1-click in-app discovery and installer for official skills and MCP servers backed by the internetdozero/orquestra-extensions monorepo, with automated static script security auditing.
  3. Global & Harness-Scoped MCP Server Registry: Enable, disable, and configure Model Context Protocol (MCP) servers globally or per individual AI harness.
  4. Master AGENTS.md Protocol: Keep your system-level rules and behavioral instructions unified across all tools without manual copy-pasting.
  5. Cross-Harness Session Telemetry & Transcript Viewer: Inspect disk footprint, turn counts, and full live conversation transcripts across all 9 harnesses with full sanitization (stripping thinking tags, extracting clean user prompts).
  6. Janitor System & Memory Guard: Prevent OOM kills on developer laptops, sweep orphan agent processes, and clean transient caches safely.
  7. Idea Vault & Inter-Agent Blackboard: Persistent scratchpad, Notion-style sorting, 1-click agent prompt copy, and productivity metrics.
  8. In-App Auto-Updater: Background release detector and 1-click update flow in Settings.

🛠️ Supported Harnesses (The 9 Core Agents)

Harness Skills Projection Path Instruction File Config / Database Integration
Antigravity (AGY) ~/.gemini/config/skills ~/.gemini/config/AGENTS.md Session logs (.system_generated/logs/transcript.jsonl)
OpenAI Codex ~/.codex/skills ~/.codex/AGENTS.md thread_history_1.sqlite + multi-file rollouts
Claude Code ~/.claude/skills ~/.claude/CLAUDE.md projects/<slug>/*.jsonl
Freebuff / Manicode ~/.agents/skills, ~/.freebuff/skills, ~/.config/manicode/skills ~/.config/manicode/AGENTS.md desktop-v2.db + project chat logs + worktrees
OpenCode skills.paths config injection Native instructions ~/.config/opencode/opencode.jsonc + opencode.db
Kilo Code skills.paths config injection Native instructions ~/.config/kilo/kilo.jsonc + kilo.db
GitHub Copilot CLI ~/.copilot/skills Native instructions session-store.db (turns schema)
Hermes Agent ~/.hermes/skills Native instructions state.db (messages schema)
xAI Grok ~/.grok/skills Native instructions chat_history.jsonl + session index SQLite

🏗️ Architecture & Stack

  • Shell / Native Core: Tauri v2 (Rust 2021, native Linux GTK/WebKit)
  • Frontend: React 19 + TypeScript + Vite 8
  • Styling: Tailwind CSS v4 (Custom Dark Zinc/Slate palette, dynamic accent themes)
  • State & Concurrency: Multi-threaded Rust backend with non-blocking read-only SQLite connections (sqlite3 bundled statically)
  • Link & Cache Optimization: mold high-performance linker + sccache + optimized codegen units

🚀 Getting Started

Prerequisites

  • Node.js: v22+ (uses native node:fs globbing)
  • Rust: Stable toolchain (rustc, cargo)
  • Linux Packages (Debian/Ubuntu):
    sudo apt-get install -y libwebkit2gtk-4.1-dev build-essential curl wget file \
      libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev

Local Development

# Clone the repository
git clone https://github.com/internetdozero/OrquestraAI.git
cd OrquestraAI

# Install frontend dependencies
npm install

# Run frontend in development mode
npm run dev

# Run full desktop application in development mode
npm run dev:tauri

# Run fast incremental dev build (embedded custom protocol)
npm run build:fast

Running Tests

# Run unit and contract test suite
npm run test:all

# Run Rust sessions and harness tests directly
cargo test --lib

📄 License

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

About

Universal AI Harness Administration & Control Plane for Claude Code, Codex, Grok, Antigravity, Freebuff, Copilot CLI, Hermes, OpenCode & Kilo

Topics

Resources

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages