clawly

Clawly

A Claude Code plugin that turns Claude into a master agent capable of juggling many tasks in parallel through tmux sessions.

Clawly runs every non-trivial task inside a dedicated tmux session so work is inspectable, resumable, and independent from the main conversation shell. Long-running processes (dev servers, watchers, REPLs) live in their own windows; one-shot commands go into panes. Task state persists across conversations via .clawly/sessions/.

Features

• Task isolation — each task runs in a clawly-* tmux session, observable via capture-pane without attaching.
• Sub-task structure — complex/long-running sub-tasks become windows; simple one-shot commands become panes.
• Persistent memory — .clawly/sessions/<name>.md snapshots survive across conversations, so a new session can cold-start with full context.
• Parallelism — up to 20 concurrent sessions and 10 windows per session.
• One-command bootstrap — /clawly:init verifies tmux, creates .clawly/sessions/, and writes a CLAUDE.md wired up to the master-agent workflow.

Installation

Add the plugin marketplace and install Clawly:

/plugin marketplace add cross-entropy-ai/claude-plugins
/plugin install clawly@cross-entropy-ai

Then initialize the workspace:

/clawly:init

All Clawly skills are namespaced under clawly: — so the init skill is invoked as /clawly:init, the tmux skill as /clawly:tmux, and so on. This avoids collisions with other plugins or your own commands.

This will:

1. Verify tmux is installed (and install it via your system package manager if not).
2. Create .clawly/sessions/ in the current workspace.
3. Generate a CLAUDE.md that wires Claude to the master-agent workflow.

Usage

Once initialized, just give Claude a task. It will:

1. Check .clawly/sessions/ and tmux list-sessions for relevant prior or live work.
2. Create or reuse a clawly-<task> session.
3. Spawn sub-tasks as windows (complex) or panes (simple).
4. Capture output after each step and interpret it before moving on.
5. Update the session summary at checkpoints so future conversations can resume.

Ask things like:

• "Start the frontend dev server and run the test watcher alongside it."
• "Where are we on the auth refactor?" — Claude reads .clawly/sessions/ and reports live status.
• "Kill all clawly sessions."

Skills

Clawly ships with two skills. They are auto-discovered by Claude from their descriptions — you rarely need to invoke them by name — but the explicit slash forms are listed for reference.

Skill	Purpose
/clawly:init	Bootstrap a workspace: check tmux, create .clawly/sessions/, write CLAUDE.md
/clawly:tmux	Create, list, send, capture, and kill clawly-* tmux sessions

Requirements

• Claude Code
• tmux (installed automatically by /clawly:init on supported package managers)

Development

bun install
bun run check   # biome format + lint + organize imports

License

See LICENSE.