insleker
ed94fde9e7
|
||
|---|---|---|
| .agents/skills | ||
| .github/workflows | ||
| .vscode | ||
| README.assets | ||
| bin | ||
| docs | ||
| examples | ||
| lib | ||
| scripts | ||
| test | ||
| tool | ||
| .env.example | ||
| .gitignore | ||
| AGENTS.md | ||
| CHANGELOG.md | ||
| README.md | ||
| analysis_options.yaml | ||
| build.yaml | ||
| lefthook.yml | ||
| pubspec.yaml | ||
| skills-lock.json | ||
README.md
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:
- examples/README.md
- examples/simple-github.yaml
- examples/simple-gitlab.yaml
- examples/simple-gitea.yaml
Environment placeholders (for example ${CWS_DISCORD_WEBHOOK}) are resolved
from process env vars and from a .env file next to your config.
Logging level can be set with CWS_LOG_LEVEL (or LOG_LEVEL): trace,
debug, info, warning, error, fatal. Minimal 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
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