documentation

agenKic-orKistrator

A magic tower AI orchestrator. Fantasy character classes working inside a vertical tower. Each floor is a project workspace — multi-model routing, real-time coordination.

Epics

Go Orchestrator Core

Supervisor, agent state machine, DAG engine, gRPC service, Redis state

Terminal Substrate Layer

tmux session management, command injection, output capture

Model Gateway / Judge-Router

LiteLLM proxy, 3-tier routing, provider adapters, fallback chains, cost tracking

Godot 4 magic tower, fantasy character agents, floor-based workspaces, HTTP/SSE bridge

Features

CAS Optimistic Locking

Compare-and-swap state transitions for agent lifecycle without distributed locks

Haiku classifies task complexity, routes to appropriate model tier

Config Loader & Fallback Chains

YAML-driven tier definitions with automatic provider failover

Per-request token logging, daily and period cost reports

Dynamic Docs Index & Publish Workflow

Manifest-driven index, GitHub Actions auto-publish, nested hierarchy

Architecture Decisions

Orchestration Pattern

Supervisor/Worker + DAG over LangGraph, CrewAI, or AutoGen

Inter-Process Communication

gRPC + Redis Streams over Unix sockets, shared memory, or ZeroMQ

State Management

Redis (Streams + Hashes + Sorted Sets) over PostgreSQL, SQLite, or blackboard

Process Supervision

OTP-style “let it crash” over defensive coding, supervisord, or PM2

Terminal Substrate

tmux CLI wrapper over WezTerm Lua, raw PTY, or X11/Wayland

Desktop Rendering

Godot 4 + godot-xterm over Tauri, egui, raylib, or SDL2

LiteLLM + Judge-Router over OpenRouter, direct APIs, or manual thresholds

TUI Alternative

Bubbletea + Lip Gloss as the headless fallback to the magic tower

Roadmap

Project Roadmap

Interactive timeline — from orchestrator core to magic tower, four epics building a visual AI agent coordination platform