All shelves / Mods / Workflow
litter
By Und3rf10w
litter is a Claude Code workflow mod by Und3rf10w.
Runs multi-agent designs, gated plans, and swarms as workflows, holds each agent to its files and tools, and opens a /litter pane of runs, swarms, and spend.
DrawsHolds a command
Install
The marketplace name is claude-litter.
/plugin install litter --marketplace Und3rf10w/claude-litterIt runs inside the Claude Code process. The side panel is only what the author's README names. Read the repo before you install, or run claude plugin validate on the plugin folder.
- Version
- 0.1.0
- Repo stars
- 8
- Last change
- 2026-10-15
What it can reach
- Draws in the session
- Reads usage or context figures
- Holds a command
- Calls another program on this machine
Claude Code 2.1.288 or later, git, jq on the PATH for the command hooks, and a POSIX sh. Runs start from a clean, committed working tree in auto or default permission mode; the mod refuses to launch under bypass-permissions or accept-edits. Or in two steps: /plugin marketplace add Und3rf10w/claude-litter, then /plugin install litter@claude-litter. The verify option is the command that decides whether a gate is done, given as an argument list. An ended run stays in the status band above the prompt for 10 minutes by default.
The marketplace, claude-litter, holds only this plugin; it replaces the repository's earlier swarm-loop, deepwork, and team-overlord plugins. Running agents as a team toward verified work is why this page files it under workflow. vbw proves every requirement with a check, draws a Mission Control pane, and denies risky commands during a run. swarmery-link reports a session to a local swarmery dashboard and, with options, holds conflicting writes. This one adds /litter:design, /litter:execute, /litter:fanout, /litter:amend, and /litter:swarm, and its mod records every step to an append-only ledger, runs your verify command itself, and commits only a tree that passed verification and an independent review. The /litter pane has eight sections: Home, Runs, Swarms, Rules, Tasks, Agents, Stats, and Doctor.
Demo

What it hooks into
session.startWhen a session startssession.endWhen a session endstool.callAround a tool call, where it can hold onemcp__litter__recordmcp__litter__swarm_proposemcp__litter__swarm_readmcp__litter__swarm_sendWorkflowTaskStopagent.spawnWhen a subagent startssession.sendA Claude Code eventturn.stepAt each step of a turnturn.startWhen Claude starts a turnprompt.submitWhen you send a promptturn.completeWhen a turn endssession.measureWhen usage is measuredagent.offerA Claude Code eventcommand.runWhen you run its slash command/clear/litterprompt.autocompleteA Claude Code eventui.renderDraws into the sessionPaneAbovePromptUserMessageui.messageAdds a message to the sessionui.pressA Claude Code eventAbovePromptUserMessageui.inputA Claude Code eventui.selectA Claude Code eventui.focusA Claude Code eventui.scrollA Claude Code event
Read from the on() calls in its hook modules. Open its source under Files to check what each one does.
Hooks 10
PreToolUseshPreToolUse · StructuredOutputshSubagentStartshSubagentStopshSubagentStopshWorktreeCreateshUserPromptSubmitshPostToolUseshPostToolUseFailureshPermissionRequestsh
Files
The author's source, 3 files. They load when you open them.
Facts
- Author
- Und3rf10w
- Category
- Workflow
- Marketplace
- claude-litter
- Folder
- plugins/litter
- Version
- 0.1.0
- Repo stars
- 8
- Last change
- 2026-10-15
- Language
- TypeScript
- Files
- 476