{
  "markdown": "# Actor-Orchestrator: Agentic Swarm Infrastructure\n\nA \"Unix-for-AI\" architecture for managing concurrent, autonomous agent workstreams using `gemini-cli` and `zmx`.\n\n![Swarm Command Center](dashboard_screenshot.png)\n\n## What is it?\nThe Actor-Orchestrator is a hierarchical agentic system that transforms a flat `TODO.md` file into an active project blackboard. It uses an **Actor Model** pattern to delegate tasks to isolated sub-agents (Workers) that operate in their own persistent terminal sessions, managed by a high-fidelity TUI Command Center.\n\n## The Vision: High-Fidelity Autonomy\n- **Cognitive Multiplier**: Offload high-throughput implementation to parallel agents while maintaining high-level architectural oversight.\n- **Physical Isolation**: Each worker runs in its own `zmx` session with unique temporary workspaces, preventing file-system conflicts and logical crosstalk.\n- **Observability**: A dedicated **Swarm Command Center** provides real-time \"Active Reasoning\" previews, event logging (PR detection), and interactive \"Jack-In\" capabilities.\n- **Self-Healing**: Automated reconciliation loops detect dead workers, audit logs for completion signatures, and update task states without human intervention.\n- **Ghost Protocol**: Hermetic execution runners that self-destruct upon completion, leaving the system temporary directories pristine.\n\n## The Hierarchy\n1.  **Meta-Orchestrator (Teddy)**: Bootstraps the environment and launches the Supervisor.\n2.  **Supervisor Actor**: Monitors the `.tasks/` directory and `TODO.md` blackboard; delegates tasks via a deterministic dispatch engine.\n3.  **Worker Actors**: Distributed engineers that execute specific tasks (Clone -> Branch -> Implement -> Verify -> Commit -> PR).\n\n## Command Center Interface\n- **Active Workstreams**: Displays live reasoning and \"thoughts\" from running workers with a subtle pulsating heartbeat.\n- **Task Ledger**: A recency-sorted list of the latest 10 tasks and their current states.\n- **System Events**: A descending feed of infrastructure events, including automated PR link capture.\n- **Interactivity**: \n    - `[S]` **Stream Log**: Focus on a specific worker's full log output.\n    - `[R]` **Refresh**: Force a data re-sync.\n    - `[Q]` **Quit**: Graceful, silent exit.\n\n## S5 Protocol (Atomic Contribution)\nAll workers follow a strict Git lifecycle:\n1.  Isolation in a dedicated branch: `task-<ID>-<slug>`.\n2.  Implementation and local verification.\n3.  Automatic push to remote and Pull Request creation via GitHub CLI (`gh`).\n4.  URL reporting back to the master Command Center.\n\n---\n\n## Installation & Setup\nEnsure you have the core dependencies installed:\n```bash\n# Install zmx (The persistent terminal layer)\nbrew tap neurosnap/tap && brew install zmx\n\n# Install gemini-cli (The agent logic)\nbrew install gemini-cli\n\n# Pre-authorize tools in ~/.gemini/settings.json\n# Ensure \"run_shell_command\", \"write_todos\", \"read_file\", \"list_files\", \"delegate_to_agent\" are allowed.\n```\n\n### Launching a Swarm\n1.  **Link the Extension**:\n    ```bash\n    cd ~/Code/actor-orchestrator && gemini extensions link .\n    ```\n2.  **Activate Mission Control**:\n    Inside any project with a `.tasks/` directory or `TODO.md`:\n    ```bash\n    ./../actor-orchestrator/commands/swarm-launch\n    ```\n\n## Technical Specs\n- **State Engine**: `.tasks/*.json` (Individual task metadata).\n- **Communication**: Shared `swarm.log` + synchronous tool returns.\n- **Runtime**: Python 3.x (Dashboard) + Bash (Runners) + Gemini CLI (Agents).",
  "bytes": 3508,
  "sha": "adc2f91ae595b6834702a902cf44c9589bcb00d2330a3f16a5b91e9ec2b580f1",
  "repo_slug": "ilteris/actor-orchestrator",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_ilteris_actor_orchestrator_4e621079/readme"
}