Skip to content

Latest commit

 

History

272 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Collie with Luma, its green and white dog logo

Running several coding agents at once turns into babysitting: one tab per agent, each waiting on you at a different moment, and no single place that says what needs a decision. Collie is the herdr plugin that takes that coordination off your hands. You pick a workflow, Collie opens the tabs, runs the agents, reviews their work, and brings you back only for the decisions that are yours. One board shows every task in the session: what needs you, what is working, what finished.

Install

Run one command. It's safe to run again, and it ends by telling you whether you're ready or what's still missing and how to fix it:

git clone git@github.com:cego/collie.git ~/.collie && ~/.collie/setup.sh

Before you run it, you need:

  • herdr installed and started once. See the herdr install guide.
  • A GitHub login: an SSH key for the clone, and gh auth login, so the install can download the runner. A glab auth login to gitlab.cego.dk, so the workflows can open merge requests there.
  • Node, so the install can fetch the skills the workflows use.
  • Claude Code, logged in. The bundled workflows run their agents on it.

The install links the plugin, puts collie on your PATH, adds four keybindings, installs the required skills, and runs collie doctor. Later, collie upgrade brings all of it up to date. Helle and a Linear MCP are optional; doctor tells you when a workflow you'd run needs one. See Install and Optional integrations for the detail.

Four keys

Key What it does
prefix+f Run a workflow
prefix+u Resume a run with unfinished steps
prefix+shift+f Fork a workflow or persona into your layer
prefix+shift+c Open this session's Control Plane

prefix is ctrl+b by default. Each herdr session has one Control Plane in a workspace of Collie's own: a board with one card per task, grouped by what needs you, what is working, and what finished, with a chat pane beside it where you can ask about the work or redirect it. prefix+shift+c reaches it from any pane and opens it when the session has none yet.

The workflows

Workflow What it does
plan Interviews you about the goal, writes SPEC.md and tickets into the run directory, then offers: implement now, second opinion, offload to Linear, refine
implement Builds from a plan, a Linear issue, or a description on a branch of its own, has the change reviewed, fixes the findings, then opens the merge request
review Reviews a merge request, a branch diff, or the working tree, writes one review, and offers to post it
architecture Runs the architect over the project, reports into the run directory, then offers: implement now or stop
renovate Merges the month's Renovate merge requests on one repository, tags a release, and checks the repository off the team's Renovate issue

The bundled workflows are a shared starting point, not a restriction. Fork any workflow or persona into your own layer with prefix+shift+f, and change only the keys you disagree with.

Every action is also a command, so an agent can drive Collie:

collie run start review --input target=worktree

Documentation

  • Using Collie: install, keybindings, the Control Plane, hand-offs, your defaults, troubleshooting.
  • Workflows: what each workflow is for, what it needs, how they chain.
  • Authoring: layers, forking, extends:, the full frontmatter schema.
  • CLI: commands, --json envelopes, exit statuses, idempotent retries.
  • Internals: architecture, the Driver, build and release, running the tests.
  • CONTEXT.md: the vocabulary.
  • ADRs: the decisions and why.
  • AGENTS.md: where an agent working on this repo starts.
  • Brand guide and brand showcase: logos, icons, color, typography, and usage. Open the showcase in a browser, or publish the assets/ directory with any static host; it has no build step.

Where Collie is going: PRODUCT.md.

About

A herdr.dev pluging

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages