🌌 Seiza (星座)

Native TypeScript AI Orchestration Engine & MCP Server with Real-Time Bento Web Dashboard.

Seiza acts as the high-performance execution layer for Head AI Architect agents (such as Antigravity IDE and Oh My Pi), coordinating specialized autonomous sub-agents (Planner, Coder, Reviewer, Scout, Librarian, Tester, Designer, Security) using OpenAI-compatible endpoints (e.g. 9Router) with parallel DAG execution, multi-agent consensus validation, sandboxing, and interactive Human-In-The-Loop (HITL) authorization.

graph TD
    Parent[Antigravity IDE / Oh My Pi Agent] <-->|MCP Stdio Protocol| Server[Seiza MCP Stdio Server]
    Server <-->|Real-Time REST Task Sync| Daemon[Seiza HTTP Dashboard Daemon]
    Server <-->|Native Engine| Core[DAG Scheduler & Engine]
    Core -->|Topological Sort| DAGRunner[DAG Parallel Runner]
    DAGRunner -->|Parallel Spawns| Runner[Sub-Agent Execution Loop]
    Runner <-->|LLM / Streaming API| Router[9Router Model Router & Fallback]
    Runner <-->|Coder/Reviewer Dialogue| Consensus[Consensus Manager]
    Runner <-->|Isolated Commands| Sandbox[Sandbox Layer]
    Runner <-->|Proxy MCP Tools| Bridge[MCP Bridge Server]
    Bridge <-->|FTS5 Memory & Graph| Amneshia[Amneshia Memory Hub]
    Bridge <-->|Code Discovery| CodebaseMCP[Codebase Memory MCP]
    Daemon <-->|SSE & REST API| Dashboard[React 18 + Vite Bento Dashboard]

✨ Core Features

• ⚡ DAG-Based Parallel Orchestration: Automatically breaks complex coding prompts into topological dependency graphs and executes non-dependent steps in parallel.

• 🤝 Multi-Agent Peer Review (Consensus Engine): Enforces automated Coder-Reviewer dialogue loops to verify diffs and safety before applying changes.

• 🔄 Real-Time Cross-Process Task Sync: Synchronizes task execution states across standalone Stdio MCP processes and the HTTP daemon via POST /api/tasks/sync and SSE streams.

• 🛡️ Dynamic Model Router & Auto-Fallback: Integrates with 9Router daemon. Automatically retries failing models (404/429/5xx) with zero-downtime exponential backoff fallback strategies.

• 🌉 Universal Downstream MCP Bridge: Seamlessly bridges tools from Amneshia (SQLite FTS5 Long-Term Memory Hub), Codebase Memory MCP, and Context7.

• 🔒 Human-In-The-Loop (HITL): Intercepts destructive commands or tasks containing #butuh-manusia, pausing execution until approved via the Bento Web Dashboard.

• 📊 Real-Time Bento Web Dashboard: Premium React 18 + Tailwind UI featuring live DAG graphs, SSE streaming logs, agent directive editors, and token counters.

• 💾 Context Inflation Shield: Logs complete sub-agent execution trails into local SQLite (sessions.db) while returning concise abstractions to the parent agent.

Related MCP server: codemesh

⚡ Quick Start & Installation

Option 1: Run Instantly (No Installation)

You can run Seiza directly via npx using the GitHub source:

# Run HTTP Web Dashboard & REST API
npx -y github:SabilMurti/Seiza --http --port 3456 --daemon

Option 2: Global Installation

npm install -g github:SabilMurti/Seiza

# Start as HTTP Daemon
seiza --http --daemon

Option 3: Standard MCP Server Setup (Stdio Mode)

Add Seiza to your MCP configuration file (mcp_config.json or ~/.omp/agent/config.yml):

{
  "mcpServers": {
    "seiza": {
      "command": "npx",
      "args": ["-y", "github:SabilMurti/Seiza"]
    }
  }
}

🛠️ MCP Tools Reference

Seiza exposes the following tools to parent agents:

🔌 Advanced Task Synchronization (API)

Seiza automatically synchronizes execution status across processes using:

• POST /api/tasks/sync: Used by Stdio MCP processes to stream live status updates to the background HTTP daemon.

• GET /api/tasks: Fetches the aggregated state of all tasks for dashboard display.

• SSE Events: The dashboard daemon streams events (task_started, task_completed, task_failed) via GET /sse.

🛠️ Development & Building

# Install all dependencies (Backend + Dashboard)
npm install

# Full build (Backend + Dashboard)
npm run build:all

📄 License

MIT © Sabil Murti