Woterclip

WoterClip

GitHub Issues-backed agent orchestration for Claude Code. A single Claude instance wears different "hats" (personas) based on GitHub issue labels – an Orchestrator routes work, a CEO makes strategic calls, and worker personas execute.

Get the persona starter pack → https://alexk1919.gumroad.com/l/woterclip-persona-pack

How It Works

1. Issues live on GitHub with persona labels (backend, frontend, etc.)
2. Heartbeat picks the highest-priority issue and resolves which persona handles it
3. Personas (CEO, Backend, Frontend, ...) define identity, tools, and runtime config
4. Reports are structured comments on the GitHub issue with progress, commits, and blockers
5. Schedule runs heartbeats automatically via Claude Code's /schedule

The human is the Board – the ultimate escalation target when the agent is blocked.

Install

In Claude Code, run /plugin → Add Marketplace → enter wotai-dev/woterclip, then install the plugin.

Or for local development:

Prerequisites

- Claude Code installed
- GitHub CLI installed and authenticated:

- A GitHub repository with Issues enabled
- Issues assigned to your GitHub account (the heartbeat queries --assignee @me)

No MCP server is required – all GitHub operations go through the gh CLI, so scheduled heartbeats work headlessly.

Note on notifications: the agent posts comments as whatever account gh is authenticated as, and GitHub never notifies a user of their own comments. If you authenticate gh with your personal account (the common setup), blocked-escalation @-mentions won't notify you – watch the repo or check /woterclip-status. A separate bot/machine account for gh auth gives you real mention notifications.

Quick Start

The Heartbeat Loop

Each /heartbeat runs an 11-step cycle:

1. Load config – read…