Terminal Workbench Pet

$ a ghost for your vault

A small floating ghost that drifts around your Obsidian workspace, peeks over headings, reads along the text you're on, spooks away from your cursor, and naps in the corner. Boop it to change its color. The one on this page is the real thing.

There's a ghost floating on this page right now. Click it to boop it, or drag it around and let go to fling it. Try the modes:
Motion — new in 1.2.0. Auto follows your system's reduced-motion preference, Calm halves the frame rate and drops the idle bob, Minimal holds the ghost still:
What it does

A companion with a personality

Not a static sticker — a little state machine that behaves like something alive.

Jellyfish drift

In float mode it cruises slowly to waypoints, hovers, and picks its next move: wander, rest, or slip off an edge and reappear elsewhere.

Peek-a-boo

It hides at the edge of a heading, code block, or image, clinging to the side with a slow bob.

Reads along

Now and then it drifts beside the paragraph in the center of your view and bobs while you read.

Spooks & naps

Get your cursor too close and it startles away with a squash-and-stretch. Idle a while and it dozes in the corner with little z's.

Follow-cursor mode

Prefer a lapdog? It trails a short distance behind your pointer and rests in place when you stop.

Boop to recolor

Click it to pet it — a happy squish, a tossed heart, and its body cycles the theme palette. Your color sticks.

Speaks up

Every so often it pipes up with a little terminal quip — zzz, reading..., boop me? — and cheers you on while you write.

Grab & fling

Pick the ghost up and drop it anywhere. Give it a flick and it sails across the workspace with momentum, then settles back into drifting.

Make it yours

Settings for size, opacity, starting color, and motion level (full, calm, or minimal for machines that hate animation), plus switches for every quirk — quips, reactions, napping, spookiness, reading-along, and tricks.

Install

Drop it in

  1. Download main.js, manifest.json, and styles.css from the latest release.
  2. Copy them into .obsidian/plugins/terminal-workbench-pet/ in your vault.
  3. Enable Terminal Workbench Pet under Settings → Community plugins. Requires Obsidian 1.5.0+.
  4. Pairs with the Terminal Workbench theme — the ghost borrows its palette — but works with any theme.