#Web UI

clawsh web opens a browser page that shows every machine in hosts.toml and its Claude Code sessions. You can open a session in a full-page terminal, start new ones and end them, without typing other commands.

#Start it

clawsh web

It prints a link like http://127.0.0.1:7421/?k=… and opens it in your default browser. Keep the terminal open; Ctrl-C stops the web UI (your sessions keep running on their machines).

To keep the access key off the command line, the browser is opened through a short-lived private file that redirects to the link. If your browser can't read it (Snap browsers such as Ubuntu's default Firefox show "file not found"), open the printed link yourself.

#What you see

• Your machines: a card per host with its sessions. Offline machines show why. The page updates by itself.
• Versions: each online machine shows the clawsh version it runs. An agent older than the hub gets an "older than this hub" pill (run clawsh update on that machine); dev builds are never flagged.
• Upgrades: after clawsh web is upgraded, an open tab reloads itself once into the new version (keeping its place in a session). If it still shows the old version after that, a banner asks you to reload. Static files are served with Cache-Control: no-cache and an ETag, and index.html links them with ?v=<version>, so a browser never keeps stale JS or CSS.
• A session: the terminal fills the page. Leaving it only disconnects you; Claude keeps working. Shift+Enter inserts a newline in a Claude Code prompt instead of submitting it (it sends ESC+CR, the same bytes as Alt+Enter, so in a plain shell session it is not a plain Enter).
• Copying: when Claude copies text (the "copied N chars" hint), it lands on your browser clipboard. If the browser blocks the write, it completes on your next click or key press in the terminal. Any program in the session can do this (it uses the OSC 52 terminal sequence), so cating an untrusted file can change your clipboard too. Copies replayed from earlier output when you open or reconnect to a session are ignored.
• Sessions panel: next to the terminal, every running session on every online machine, grouped by machine (newest first) with its name and when it started. Click one to switch the terminal to it (the address changes, so Back and bookmarks work). New session at the top starts one without leaving the view; Cancel stays where you are. Ending a session opens the next one in the list, or the machines page if none is left. The toggle collapses the panel to a narrow rail (remembered in the browser). Under 900px wide it starts collapsed and opens over the terminal. With the terminal focused, Alt+↑ / Alt+↓ (or Alt+[ / Alt+], for macOS) switch to the previous / next session. These keys are not passed to the program in the terminal while it is focused.
• New session: pick a machine, a folder and optionally a name and extra Claude arguments. Under the folder field, the folders recently used on that machine show up (3 at first, "Show all" for the rest); click one to fill the field. The list follows the machine you pick and stays hidden when there is none.
• Duplicate: the copy button on every session row (live or exited) opens the same dialog prefilled with the source session's machine, folder, name and extra arguments. The name gets a counter (api (2), api (3), …) while another running session on that machine already has it. If the source machine is offline, another online one is preselected. Arguments with spaces are shown in double quotes (--append-system-prompt "be brief"). Copying the transcript is not supported yet.
• Machines page (Machines in the top bar): add, edit, test and remove machines without editing hosts.toml. The access key field is write-only: saved keys are never sent back to the browser, and leaving it empty on edit keeps the saved key. Test connection checks the address and key (reports reachable, unreachable or key rejected) before or after saving. Saving rewrites hosts.toml (written atomically, mode 0600); comments in a hand-edited file are dropped, and the previous version is kept as hosts.toml.bak. If hosts.toml doesn't parse, the page refuses to save until you fix it by hand.
• No machines yet: the steps to add one, or a link to the Machines page. The page notices when you save hosts.toml.
• Hosts file errors: if hosts.toml stops parsing while clawsh web runs, a banner shows the error and the page keeps the machines from the last good version until you fix and save it.

#Limits

• Opens only on the computer running clawsh web (see Security). Phones and other devices: issue #6.
• Machines are added by hand-typed access key; fetching keys without running clawsh token on each machine is issue #46.
• Dark theme only.

Edit this page on GitHub