agentrelay
agentrelay is a Python orchestration system for multi-agent coding workflows.
It models work as a dependency graph of tasks and coordinates execution through
observable artifacts (git branches/worktrees and filesystem signals).
Project Direction
The project is evolving from a working prototype that implemented a specific workflow (Claude Code agents running in tmux) toward a pluggable architecture. Current development is focused on making orchestration easier to extend to additional coding-agent frameworks and cloud execution environments.
Current Scope
Implemented today:
- Core architecture types in
src/agentrelay/(TaskGraph,TaskGraphBuilder,TaskRuntimeBuilder,WorkstreamRuntimeBuilder,TaskRunner,Orchestrator,WorkstreamSpec,Task,TaskRuntime,WorkstreamRuntime,Agent,AgentEnvironment) - A runnable prototype orchestrator in
src/agentrelay/prototypes/v01/ - Test coverage for both layers (
test/plus prototype tests)
Not implemented yet in the current architecture layer:
- Non-stub
TmuxAgent.from_config()andTmuxAgent.send_kickoff()
Quick Links
- Architecture - Core abstractions and design intent
- Workflow - What workflow behavior is implemented today
- Task Graph Schema - YAML schema and defaults for
TaskGraphBuilder - Migration Guide - Moving older graph YAML to current schema/behavior
- Guide - Setup and common development/prototype commands
- Testing - Test scope and validation commands
- Prototype v01 - Historical/runnable prototype docs
- API Reference - Auto-generated from code
- Changelog - Main project history
- Backlog - Near-term work items