bkinnightskytw
/
code_work_spawner
1
0
Fork 1
Code Issues 1 Pull Requests Packages Projects Releases Wiki Activity
code_work_spawner/README.md

2.9 KiB
Raw Permalink Blame History

code_work_spawner

Repository issue thread assistant configured by YAML.

It watches GitHub, GitLab, Gitea, or OpenProject issue events, reads threads, and triggers CLI responders such as codex, opencode, or copilot-cli.
Supports multi-repo config, responder fallback chains, isolated worktrees, and optional Discord or desktop notifications.

Highlights

  • Track issue events across multiple repositories
  • Reply on mentions or meaningful thread updates
  • Run planning and bug verification in isolated worktrees
  • Send optional Discord and desktop notifications

Requirements

  • Dart SDK
  • Authenticated gh, glab, tea, and/or OpenProject API credentials
  • Local checkouts for configured repositories
  • Optional responder CLIs (codex, opencode, copilot-cli)

Config

Create CWS_conf.yaml using:

Environment placeholders (for example ${CWS_DISCORD_WEBHOOK}) are resolved
from process env vars and from a .env file next to your config.

Set logging with --log-level trace|debug|info|warn|error or env
CWS_LOG_LEVEL / LOG_LEVEL. Precedence: CLI > env > default info.
Minimal env example: .env.example.

Generate 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

Generate code first:

dart run build_runner build --delete-conflicting-outputs

Run once:

dart run bin/code_work_spawner.dart --once

Run continuously:

dart run bin/code_work_spawner.dart
# With higher verbosity for troubleshooting:
dart run bin/code_work_spawner.dart --log-level debug

Override CLI paths if needed:

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

Install Binary

Install latest release binary:

# export GH_TOKEN="$TOKEN" # If got 404, `GITHUB_TOKEN` also work
uv run https://github.com/existedinnettw/code_work_spawner/scripts/install.py
uv run https://$GH_TOKEN@raw.githubusercontent.com/existedinnettw/code_work_spawner/main/scripts/install.py --help

Install a specific version:

uv run https://github.com/existedinnettw/code_work_spawner/scripts/install.py --version v1.0.0

Testing

dart run tool/validate_gherkin_test_format.dart
dart analyze
dart test

ref

agent-orchestrator