@aleclamble/slop-cop
v1.0.3
Published
Agent-agnostic GitHub issue intake, repo scouting, and isolated worktree PR automation.
Maintainers
Readme
Slop Cop
cd my-repo
npm install -g @aleclamble/slop-cop
slop-cop init
slop-cop service install --startSlop Cop is an agent-agnostic local automation runner for GitHub-backed repos. It watches prefixed issues, gives each issue to a coding agent in an isolated git worktree, and opens a pull request when the work is ready.
Slop Cop never auto-merges. It uses GitHub Issues as the queue and GitHub Pull Requests as the review surface.
Requirements
- Node.js 20+
- npm 10+
- Git 2.38+
- GitHub CLI (
gh) authenticated with repo access - A GitHub repo with Issues enabled
- At least one supported agent CLI:
codex,claude,opencode, or a custom command
Commands
slop-cop init
slop-cop doctor
slop-cop status
slop-cop run intake
slop-cop run scout
slop-cop start
slop-cop stop
slop-cop service install --start
slop-cop logsSafety Model
- The active worktree is only modified by
init, which writes.slop-cop.yml. - Issue work happens in separate git worktrees.
- Completed work opens PRs; Slop Cop does not merge them.
- Background state and logs live under
~/.slop-cop. - Scout issue creation is chosen during
init; the guided default iscreate.
Configuration
Each repo has its own .slop-cop.yml. Run slop-cop init to choose the prefix, agent, approval behavior, scout categories, and intervals without opening the config file.
More detail:
