TerMuse: watch your Muse agent's machine

# TerMuse

**See the computer your Muse agent is actually using.**

Your Spark agent on [muse.ai](https://muse.ai) works on a real machine — a
real shell, a real browser, real files. You normally only see what it
chooses to tell you about that machine in chat.

TerMuse gives you the machine itself, in one page: **your agent's live
terminal on the left, a fully interactive browser on the right.** Every
command it runs, every page it opens. And you're not just watching — you
can type into that terminal and click in that browser yourself, at any
moment, in the same session your agent is using.

![TerMuse: the agent's live terminal on the left, its localhost app rendered
and clickable on the right](docs/termuse.png)

*Above: the agent just ran `npm install -g hermes-web-ui` and started it on
`localhost:8648` — you can read that happening in the left pane. The right
pane is that same localhost app, rendered and fully clickable, on a machine
your browser has no route to. Follow mode is on, and the divider is
draggable (40/60, 50/50, 60/40).*

## Why this exists

Two things are normally impossible from your side of the screen:

- **You can't see the agent's shell.** You get a summary of what it did.
  TerMuse gives you the actual pane, live, and lets you type in it.
- **You can't open the agent's localhost.** When your agent builds a web
  app and runs it on `localhost:3000`, that server exists only on *its*
  machine. Your browser has no route to it. TerMuse renders it anyway —
  and lets you click around in it.

That second one is the whole trick, and it's why this repo exists instead
of a browser extension.

## Setup

Two steps. Your agent builds the view; you run one command inside it.

### Step 1 — paste the prompt to your agent

1. Open **[`PROMPT.md`](PROMPT.md)**.
2. Copy everything below the `---` divider.
3. Paste it to your Muse Spark as a single message, with a link to this repo:

   > Here's the repo: `https://github.com/jjakemaness/termuse`
   >
   > *(then the pasted prompt)*

4. Wait a few minutes. Your agent builds the split view, tests every
   control, and hands you a private link with its results.

Open the link. You should have a terminal on the left and a browser on the
right, and you should be able to **type in one and click in the other**.

### Step 2 — run the installer in your new terminal

Only your agent can build the view. Everything af