WoterClip
Stop babysitting your AI coding agent.
WoterClip is a Claude Code plugin that turns Linear into your agent control plane. Persona-based routing, structured heartbeats, automatic escalation. Zero infrastructure.
Architecture
How It Works
WoterClip wires together what you already have – Linear issues and Claude Code.
File Issues
Create issues in Linear as usual. Add a persona label – backend, frontend, ceo – to route work.
Heartbeat Picks Up
Run /heartbeat or schedule it every 15–60 min. WoterClip grabs the highest-priority issue.
Persona Executes
The matched persona loads its SOUL.md, tools, and config. Claude works with the right context.
Report & Escalate
A structured comment with commits and status. Blockers auto-escalate with @-mentions.
Persona Hierarchy
Board (you) ← ultimate escalation target
• CEO ← strategy, prioritization, architecture
• Orchestrator ← fast mechanical routing (Haiku)
• Workers ← backend, frontend, custom personas
Capabilities
Built for Production
Persona-Based Routing
Each persona is a directory with SOUL.md, TOOLS.md, and config.yaml. Backend runs on Opus with 300 turns. Frontend runs on Sonnet with 200. Same Claude instance, different hat.
CEO/Worker Hierarchy
The Orchestrator triages fast on Haiku. The CEO decomposes complex work and makes architecture decisions. Workers execute. You only get pulled in for real decisions.
Heartbeat Execution
Run /heartbeat manually or schedule it every 15–60 minutes. WoterClip picks the highest-priority issue, matches the persona, does the work, and reports back.
Linear as Control Plane
Issues, priorities, and status all live in Linear. Labels drive routing. Comments provide audit trails. No new tools to learn.
Automatic Escalation
When the agent can't proceed, it labels the issue agent-blocked, posts a comment explaining why, and @-mentions you. Next heartbeat picks it back up after you unblock.
Zero Runtime Code
No TypeScript. No build step. No dependencies. The entire system is markdown and YAML files. Customization means editing text, not writing code.
Comparison
WoterClip vs Alternatives
| Approach | Setup | State | Escalation | Audit Trail |
|---|---|---|---|---|
| Manual Claude Code | None | You remember | You notice | Terminal history |
| Custom agent scripts | Hours–days | Custom database | Custom logic | Custom logging |
| Paperclip | API server + database | Paperclip API | API-based | API-based |
| WoterClip | /woterclip-init | Linear labels | Linear comments | Linear comments |
Get Started
Up and Running in 2 Minutes
Prerequisites
- Claude Code installed
- Linear MCP connected
- A Linear workspace with at least one team
Install the plugin
claude plugin add wotai-dev/woterclipInitialize in your repo
/woterclip-initRun your first heartbeat
/heartbeatCommands
/heartbeatRun one heartbeat cycle/woterclip-statusCurrent queue, blocked issues, recent activity/persona-createCreate a custom persona/persona-listList configured personasRoadmap
What's Next
WoterClip v1 is intentionally minimal. The foundation is right – everything else builds on it.
Need workflow automation? WotAI Flow generates n8n workflows with AI. Need brand-first content? WotAI Echo turns your Brand DNA into content that sounds like you.
Common Questions
Frequently Asked Questions
What is WoterClip?
WoterClip is an open-source Claude Code plugin that turns Linear into an agent orchestration layer. It uses persona-based routing to let a single Claude instance handle different types of work – backend, frontend, strategic decisions – based on Linear issue labels.
How is WoterClip different from Paperclip?
WoterClip takes Paperclip's best ideas (persona routing, CEO/worker hierarchy, structured heartbeats) and rebuilds them as a Claude Code plugin backed by Linear. No API server, no database, no separate processes – just markdown and YAML files.
Do I need to write code to use WoterClip?
No. WoterClip has zero runtime code. The entire plugin is markdown files (skills, personas) and YAML (config). You customize it by editing text files, not writing TypeScript.
What are personas in WoterClip?
Personas are directories with three files: SOUL.md (agent identity), TOOLS.md (available tools), and config.yaml (model, turn budget). Each persona shapes how Claude behaves for a specific type of work. The default personas are Orchestrator, CEO, Backend, and Frontend.
What do I need to run WoterClip?
Claude Code installed, Linear MCP connected, and a Linear workspace with at least one team. Install the plugin, run /woterclip-init, and you're ready.
Can I create custom personas?
Yes. Run /persona-create to make a new persona interactively, or copy an existing persona directory and edit the files. Common additions include QA, DevOps, and Docs personas.
Is WoterClip free?
Yes. WoterClip is MIT licensed and fully open source. No paid tiers, no usage limits, no lock-in.