Skip to content

About

brings agentic superpowers to the pane-driven.

Topics

Resources

Security policy

Stars

14 stars

Watchers

0 watching

Forks

Repository files navigation

herdrpowers

Development workflows for AI coding agents in herdr, adapted from obra/superpowers.

Coordinates planning, implementation, testing, and review across agent panes.

Features

  • Automatic task delegation from the orchestrator to agent panes.
  • Independent pane contexts, with configurable separation of test authors and implementers.
  • Superpowers features adapted for development across panes.
Superpowers herdrpowers
worker in-process subagent idle sibling herdr pane; a profile without a separate coder or reviewer, or a role whose pane is not open, uses a fresh subagent
task loop subagent-driven-development pane-driven-development
parallel work dispatching-parallel-agents panes, bounded by idle panes and worktrees
entry point skills trigger themselves commands/ workflows, plus the same skills
routing fixed in the skill .herdrpowers/config.yaml over roles.yaml, plus an optional profile
who writes tests the implementer, always the test-authoring assignment
review one reviewer subagent a role bound to a list of agent types: one review per entry

Getting started

Claude Code

/plugin marketplace add transparent-pegasus/herdrpowers
/plugin install herdrpowers@herdrpowers

Codex

codex plugin marketplace add https://github.com/transparent-pegasus/herdrpowers
codex plugin add herdrpowers@herdrpowers

Cursor

cursor-agent plugin marketplace add https://github.com/transparent-pegasus/herdrpowers

Alternatively, install from this repository through the Cursor Marketplace.

OpenCode 2

opencode plugin add git+https://github.com/transparent-pegasus/herdrpowers.git

Use opencode2 if that is your binary's name. For OpenCode 1, see OpenCode setup.

Antigravity

agy plugin install https://github.com/transparent-pegasus/herdrpowers

Run the same command again to update. Antigravity plugins cannot ship commands, so each workflow comes as a skill, listed in the interactive CLI as /herdrpowers:..:.antigravity-plugin:commands:<name>. Typing /herdrpowers:<name> selects it, except /herdrpowers:plan, which selects /herdrpowers:writing-plans: pick plan from the menu instead.

Install with agy plugin install, not agy plugin import. Importing herdrpowers from Claude Code converts it, drops commands/, and leaves the workflow skills pointing at files that no longer exist. Running the install command over an imported copy replaces it.

Initialize your repository

Run the init workflow once per repository:

/herdrpowers:init

Then tell your agent what you want to build.

Development workflows

The agent normally chooses between full_cycle and quick based on the task. Invoke either command when you want to choose explicitly.

Use plan followed by execute or execute_parallel to separate planning and execution in time or across execution environments.

Choose execute for sequential execution, or execute_parallel to run independent tracks in parallel worktrees.

See Workflows for all commands and how to invoke them in each agent.

Configuration

Repository settings stay outside the plugin and survive updates:

  • AGENTS.md / CLAUDE.md: base branch, verification commands, and shared worktree directory (WORKTREE_DIRECTORY, default .worktrees/).
  • .herdrpowers/config.yaml: agent roles, task assignments, delegation scope, review settings, the selected profile, allow_agent_lifecycle, and reviewer_usage_limit.
  • .herdrpowers/profiles/: presets for role targets, models/effort, and optional fallback, delegation, and assignment overrides. Init installs the shipped ones without overwriting yours; their README explains the names.
profile: fable                # or name one in the task; null selects none
allow_agent_lifecycle: false  # true: the orchestrator may start and end agents in panes
reviewer_usage_limit: skip    # wait: hold a review gate until a usage-limited reviewer resets

A profile slot written any takes its target from the task, as in solo Opus 5.5 max or neon-fable coder: codex; parts left out stay open. A profile overrides only present keys. Omitted keys keep config/default values; maps merge per key and lists replace, including empty lists. Assignment overrides may change modes and review gates; lifecycle permission remains config-only. Model and effort must match what each pane shows in its footer; effort: any leaves the effort to the orchestrator, which reports its choice. A role whose pane is not open, with no usable fallback, runs in a fresh subagent of the orchestrator's own kind unless delegation.subagent_fallback is false. With allow_agent_lifecycle: true the orchestrator starts the selected composition's missing agents in idle shell panes and ends the ones it started; with false, the default, it never starts or ends an agent. See Roles for the rules.

Relative worktree paths resolve from the primary checkout so all agents share the same parent directory. Delegation stays within one herdr tab unless configured otherwise.

Requirements

Delegation requires herdr with herdr --skill support and available agent panes. Planning, TDD, debugging, and verification skills also work outside herdr.

Verify new or upgraded delegation targets with the composer probe.

Documentation

Workflows · Roles · Skills · OpenCode setup

License

MIT. See NOTICE for attribution.

About

brings agentic superpowers to the pane-driven.

Topics

Resources

Security policy

Stars

14 stars

Watchers

0 watching

Forks

Contributors

Languages