code_work_spawner

Repository issue thread assistant with an Agent Orchestrator style YAML config.

It polls configured GitHub or Gitea repositories with gh or tea, reads
issue threads, and uses CLI responders such as codex, opencode, or
copilot-cli to decide when to reply. It supports multi-repo config,
responder fallback chains, and optional Discord webhook and desktop
notifications.

Highlights

• Poll GitHub and Gitea issues across multiple repositories
• Trigger replies from mentions or meaningful thread updates
• Run planning and bug-verification flows in isolated worktrees
• Send optional Discord or desktop notifications for assistant events

Requirements

• Dart SDK
• gh and/or tea CLI authenticated for the target repositories
• Local checkouts for configured repositories
• Optional local responder CLIs such as codex, opencode, or copilot-cli

Config

Create a local agent-orchestrator.yaml and use
examples/README.md plus
examples/simple-github.yaml as the reference.

Generate a starter config:

dart run bin/code_work_spawner.dart init-config
# Write it to a file:
dart run bin/code_work_spawner.dart init-config --output agent-orchestrator.yaml
# Overwrite an existing file:
dart run bin/code_work_spawner.dart init-config --output agent-orchestrator.yaml --force

Run

dart run build_runner build --delete-conflicting-outputs

Single poll cycle:

dart run bin/code_work_spawner.dart --once

Long-running poller:

dart run bin/code_work_spawner.dart

Override tracker CLI paths when needed:

dart run bin/code_work_spawner.dart \
  --config /path/to/agent-orchestrator.yaml \
  --db /path/to/state.sqlite3 \
  --gh-command /usr/bin/gh \
  --tea-command /usr/bin/tea

Testing

dart run tool/validate_gherkin_test_format.dart
dart analyze
dart test

ref

agent-orchestrator