Claude Code mod
agent-theater
A pixel theater under the prompt: the little orange guy acts out what Claude is doing, with Haiku narration in a speech bubble.
Install
git clone https://github.com/joydeep-pm/agent-theater.git
claude --plugin-dir ./agent-theater/.The repo has no marketplace file, so load the plugin folder directly with --plugin-dir.
What it can access
- Reach
- L2Writes or runs: drives Claude, reads mod state, persists state, draws
- Sees
- every prompt, every tool call
- Draws in
SpinnerAbovePrompt- Hooks
session.startcommand.runprompt.submitturn.starttool.callturn.completeui.render
From a static scan of the mod's code by awesome-claude-code-mods. It shows what the code asks for, not a security review.
How Claude Code mods work
- A mod is a plugin with a JavaScript or TypeScript module that runs inside Claude Code (version 2.1.287 or later). It can draw panes beside the transcript, a band above the prompt, buttons and toasts, restyle the spinner and tool rows, and watch or rewrite tool calls and prompts.
- It installs like any plugin: add its marketplace with /plugin marketplace add owner/repo, then /plugin install name@marketplace.
- Check what a mod can reach before installing: it runs with your permissions. Reach goes from drawing only, to reading files, to writing files or running processes, to the network. Run claude plugin validate on a clone to list its hooks and calls without running it.
- Turn one off from the Installed tab in /plugin, or start Claude Code with --safe-mode to skip every customization for a session.
Details
- Repository
- joydeep-pm/agent-theater
- Folder
.- Last updated
- 4 October 2026
- Listed in
- awesome-claude-code-mods
FAQ
What is agent-theater?
A pixel theater under the prompt: the little orange guy acts out what Claude is doing, with Haiku narration in a speech bubble. It is a mod for Claude Code, from joydeep-pm/agent-theater on GitHub.
What can the agent-theater mod access?
Its widest reach is "writes or runs" (drives Claude, reads mod state, persists state, draws). It sees every prompt, every tool call. It draws in Spinner, AbovePrompt. Like any mod, it runs with your permissions.
How do I install agent-theater?
Clone joydeep-pm/agent-theater and start Claude Code with --plugin-dir pointing at the mod's folder (.).
More pane & dashboard mods
agent-theater
afu-it/agent-theater
A pixel theater above the prompt: little orange Claude acts out each tool call at a desk while a monitor shows the command and Haiku narrates it.
agent-todos
IrvingAguilar/claude-agent-todos
Live todo list of the tasks agents are running, with ODD feature tasks, in a side pane or a band above the prompt
agent-taskboard
YohanGarcia/agent-taskboard
A live task board for Claude Code: plans before building and shows every task, its status, time, subagents and checks in a side panel. Progress survives sessions.
agent-trace
YeomYuJun/claude-mods
Reads the subagents, agent teams and Workflows the session launched from its transcript files and draws them in a docked panel as a flow diagram, agent details and file access
agent-squad
poppydad/agent-squad
A side pane showing every subagent as a little stick person, with progress and unreasonable commentary
agent-tree
Teodagher/teo-mods
Live board of your subagents: a little Claude critter per agent and one sentence on what it is doing
Browse the most popular Claude Code mods, all pane & dashboard mods, or the skills and MCP server directories.