● Claude Code mod · MIT

Meet robot.

A little robot lives above your Claude Code prompt. It walks, dances and goes fishing while Claude works.

claude — ~/my-app
>
 
install in Claude Code

Two lines.
That's it.

macOS, Linux and Windows. No daemon, no network, nothing else to install.

  1. 1
    Add the marketplace, in the Claude Code prompt/plugin marketplace add egor-xyz/robot
  2. 2
    Install the robot/plugin install robot@robot
  3. 3
    DoneThe robot appears above the prompt. No restart.
/robot

Hide or show the robot. It stays that way.

/robot status

Hide or show the status line.

/robot changes

Hide or show the PR and files line.

/robot play

The robot plays the slot machine.

/robot dice

The robot becomes a die, rolls to the middle, and lands on 1 to 6.

/robot coin

The robot flips a coin. Yes or no.

/robot animate ufo

The robot plays any animation by name. Leave the name out to see the list.

/robot files

See the changed files and their diffs.

/robot agents

See every running subagent in a panel.

/robot calm

A slower robot with only its quiet acts. Run it again to turn it off. Play, dice, coin and animate still work.

/plugin → robot → Configure

Turn the fire off, or set when it starts.

/plugin marketplace update robot

Get the newest robot. It reloads by itself.

it follows Claude Code

Calm, it plays.
Claude acts, it reacts.

  .🔥-🔥.
  [O   O]   context 31%
  /|───|\   /compact me!
   o   o

Context too big?

Past 25% context, its head catches fire. It paces, panics and asks you to /compact.

🧊·.-----.🧊
   [o   o]   b-b-brr…
  */|───|\·  cache frozen!
🧊  o   o 🧊

Cache gone cold?

After a break, the prompt cache expires and your next message costs more. The robot freezes blue in ice, and the status line shows ❄ cache cold · 117k.

  ┌───────┐
  │ robot │
  │ ↑ ↑ ↑ │
  └───────┘

Compacting?

Robots and WALL-Es ride a factory line into boxes, under the spinner's "Compacting" text, until it ends. Arrows squeeze the ctx percent in the status line.

(o)(o)    .-----.
=[##]=    [o   o]
(oooo)    /|───|\

Subagents running?

A WALL-E friend rolls in for each agent. Past three, a +N. Open an agent's transcript and the robot steps aside.

  git commit  ✓
  git push    ↑

Git commit or push?

It cheers for 3 seconds. Its friends hop too.

? Which one
❯ 1. This one
  2. That one

Claude asks you?

It steps aside. It never blocks your answer.

  🛸       .-----.
 /  \      [O   O]
  🐄       /|───|\

Nothing going on?

It plays: 25+ hand-drawn acts, like a UFO taking a cow from a random gap in the woods, or a caped hero zapping targets with eye lasers.

25+ hand-drawn animations

Edge to edge.
All day long.

When Claude is busy, the robot plays. Here are some of its acts, as they look above your prompt. Each one has its own colour.

.-----.
[o   o]
/|───|\
 o   o
walk
.-----.\o
[o   o]
 |───|
 o   o
wave
.-----.
[- _ -]
/|───|\
 o   o
sleep
.-----.
[o   o]
/|─u─|\
 o   o
smile
.-----.
[O   O]
 |───|
 '   '
jump
.-----.         🌙
[- - O]    ==o
/|───|\    |
 o   o    / \
moon nap
.-----.  🏀
[⌐   ⌐]    --|_|
/|───|─       |
 o   o        |
hoops
.-----.
[o   o]  ·
/|───|──o
 o   o  💥
campfire
.-----.  🐟
[^   ^]──/✨
/|───|
 o   o  ~~~~~
fishing
.-----.
[-   -] ~
/|───|─☕
 o   o
coffee
.-----.
[o   o]
/|───|─o
 o   o  🌱
garden
.-----.  🎈
[o   o] /
/|───|─o
 o   o
balloon
.-----.
[o   o]    ______
/|───|\    |: : :|
 o   o     | ⚽  |
goal
    .-----.
🎵  [o   o]
  🎤─|───|\
     o   o
concert
.-----.\o
[O   O]   ✨
 |───|    📸
 o   o    /|
photoshoot
 🛸      .-----.
/  \     [O   O]
 🐄      /|───|\
          o   o
UFO
/\   /\
.-----.
[o   o]
cat peek
subagent friends

Every agent gets
a little WALL-E.

                       .-----.
(o)(o) (-)(-) (O)(o)   [o   o]
=[##]= =[##]= =[##]=   /|───|\
+2 (oooo) (oooo) (oooo) o   o

They roll in

When an agent starts. Their wheels pulse.

They are alive

They blink, look around and stretch up.

They panic too

Context on fire? Their eyes go wide.

They wait at the right edge

They roll in from the right and wait in fixed slots. Now and then they all shuffle a cell together.

A high five

Now and then the robot walks over to the nearest friend. Both raise a hand, slap with a spark, and all the friends hop.

An excavator

Rarely, the friends creep toward the robot. It frowns, turns into an excavator part by part, pushes them home and pops back up.

Three at most

More agents? A +1, +2… shows them.

status line

A custom
status line.

The robot draws it. It replaces nothing: Claude Code's own hint line stays right under it.

What is in it

Account, model and effort, project folder, git branch, 7d and 5h limits with time left until reset, session cost, context %. A worktree folder named like its branch shows once, as the branch.

Model colors

Opus orange, Sonnet blue, Haiku green, Fable pink. Project folder teal, branch blue.

Effort warms up

low and medium stay grey, high and xhigh yellow, max red.

Grey until it matters

Limits turn yellow at 50% and red at 80%. Cost turns yellow above $100. ctx turns red at the "Fire at" setting (default 25%). The exact shades come from your Claude Code theme: dark, light, color-blind or your terminal's own colors.

The branch shimmers

When the branch changes, or after a git commit or push, a bright band sweeps across the branch name for 3 seconds: feat/login.

A line per subagent

Each running subagent gets a ↳ line: task, type, model and effort, tokens and time. Up to 3 show, then +N more. After a plugin reload, running agents get their lines back.

Follows the agent in view

Open a subagent from the tasks list and the status line shows that agent's model, effort, tokens and time in place of the session's.

changed files and your PR

Every file you touched.
One click away.

One line under the status line counts the files git would commit. With a PR open, it counts all the PR's files. Click it, or run /robot files: a panel lists them.

Your PR, in two groups

With a PR open (found with gh), the files come in two groups: not committed yet, and already in the PR. The panel title links to the PR in the browser.

A diff for each file

Open a file to see its diff, in color. ↗ open opens the file in its default app. ← files goes back.

Find it fast

Type in the search box to find a file. ↓ walks the files, Enter opens one. With the mouse, click once to select, click again to open.

Big PRs too

The panel lists hundreds of files. The file under the mouse shimmers, and so does the line. Esc or Close closes it.

more tricks

Needs you.
Beaming…

Needs you

Claude ends its turn with a question for you? The robot dances and says "need a human" in a comic speech bubble. It goes away when you send your next message.

Cache cold

After a break the prompt cache goes cold. Ice cubes gather around the robot, it turns blue and says "b-b-brr… cache frozen!", and the status line shows ❄ cache cold · 117k: the context your next message re-reads at full price.

Robot spinner words

The spinner shows a robot word each turn, like "Beaming…" or "Recharging…".

settings

Your robot,
your rules.

In Claude Code, type /plugin, open Installed, pick robot, choose Configure. Change a value and save. It applies at once. /robot, /robot status, /robot changes and /robot calm flip the Robot, Status line, PR and files line and Calm settings (each run flips one), and they stay that way.

SettingDefaultWhat it does
Robottruefalse hides the robot above the prompt. Each /robot flips it.
CalmfalseA calmer robot: half speed, only its quiet acts, no git cheer, factory line or branch wave. Each /robot calm flips it.
Status linetruefalse hides the status line under the prompt. Each /robot status flips it.
Context on firetruefalse turns the burning-head act off.
Fire at (% context)25Context % where the head catches fire and ctx turns red.
Cache coldtruefalse turns the ice cubes and the status line's ❄ cache cold part off.
Cache TTL1hHow long the prompt cache lives: 1h, 5m, or auto (5m until a chat shows a 1-hour cache).
Compacting factory linetruefalse turns the factory line during /compact off.
Git cheertruefalse stops the ✅ / 🚀 on commit and push.
Subagent friendstruefalse hides the WALL-E friends.
Limits shownbothWhich limits the status line shows: both, 5h or 7d.
Limits from (% used)0A limit shows only from this %; 0 shows it always.
Needs youtruefalse stops the "need a human" bubble.
Robot spinner wordstruefalse keeps Claude Code's own spinner words.
Branch wavetrueA bright band shimmers across the branch name for 3 seconds when the branch changes, and after a git commit or push. false keeps it still.
Subagent linestrueOne line for each running subagent under the status line: task, type, model, tokens and time. false hides them.
PR and files linetrueOne line under the status line: how many files git would commit (with a PR open, all the PR's files, with the lines added and removed), and the open PR's checks, conflicts, unresolved review threads and auto-merge. A toast says when something new needs you. Click it, or run /robot files, for the list. Uses gh. Each /robot changes flips it. false hides the line and the toast.
Update toasttrueA toast when a new robot version is out, with the commands to update. Checks GitHub every 6 hours at most. false turns it off.
Reset all settings to defaultfalseSet to true and save: every setting goes back to its default, and this switch goes back to false.
bonus · no Claude Code needed

The same robot,
full screen in your terminal.

A screensaver in the spirit of cmatrix and sl, with a slot machine inside. It needs zsh.

  1. 1
    Install it, in your shellcurl -fsSL https://raw.githubusercontent.com/egor-xyz/robot/main/install.sh | bash
  2. 2
    Run itrobot
  3. 3
    Update it laterRun the install line again. It moves to the latest release.

Keys

↑↓
Next or previous animation. Also k and j.
Space
Play the slot machine (in Claude Code: /robot play).
→
Open the settings.
←
Back to the robot.
qEsc
Quit.