clawsh

See and drive every Claude Code session on every machine in your LAN from one terminal.

clawsh ls
TARGET         NAME      STATUS   VIEWERS  AGE    DIR
desk/815856a6  api       running  0        2h14m  /home/alvaro/src/api
laptop/3fa0c1  frontend  running  1        12m    C:\src\frontend

One binary, two roles:

• agent: runs on each machine, owns claude processes inside PTYs (ConPTY on Windows), keeps them alive while nobody is watching, and serves a small REST + WebSocket API.
• hub: the hosts / ls / new / attach / kill / web commands, run from whichever terminal you're in.

Full docs are at https://varogonz95.github.io/clawsh/docs/ (source in docs/wiki/); the landing page is https://varogonz95.github.io/clawsh/ (source in site/index.html)

Setup

Install the latest release (checks the download against the release's checksums, no sudo or admin needed):

curl -fsSL https://varogonz95.github.io/clawsh/install.sh | sh   # Linux, macOS

irm https://varogonz95.github.io/clawsh/install.ps1 | iex   # Windows PowerShell

With Node 18+: npm i -g clawsh-cli (the command is still clawsh), or run it without installing: npx clawsh-cli ls. Update later with clawsh update. Prebuilt binaries are also on the Releases page. To build from source, see Building from source.

On each machine that should host sessions:

clawsh agent            # listens on :7420, creates a token on first run
clawsh token            # prints the token

Windows: allow clawsh.exe through Windows Defender Firewall (private networks) when prompted.

On the machine you drive from, copy hosts.example.toml to the path shown by clawsh help, fill in each agent's URL and token, then:

clawsh hosts                                   # who's reachable
clawsh new desk --dir ~/src/api                # start claude there and attach
clawsh new desk --dir ~/src/api -- --resume    # pass args through to claude
clawsh ls                                      # everything, everywhere
clawsh attach desk/8158                        # id prefix is enough
                                            # Ctrl-] detaches, session keeps running
clawsh kill desk/8158

Building from source

Needs Go 1.22+ and make. No cgo, so no C toolchain is required.

git clone https://github.com/varogonz95/clawsh.git
cd clawsh
make build           # produces ./clawsh (or: go build -o clawsh ./cmd/clawsh)
make test            # race-enabled tests
make vet             # vet for linux, windows and darwin
make dist            # cross-compile all platforms into dist/
make docker-dist     # same, built inside Docker (needs buildx, no local Go)

Try it without installing: run an agent with any command standing in for claude, then point a hosts.toml at it (see Setup).

./clawsh agent --claude /bin/sh     # listens on :7420
./clawsh token                      # token for hosts.toml (url http://localhost:7420)

Security

Anyone holding an agent's token can run Claude Code on that machine, with that machine's permissions. Traffic is plain HTTP, so keep agents on a trusted LAN until TLS/Tailscale support lands (see docs/PLAN.md). The command an agent runs is fixed by --claude on the agent; the API only accepts extra args.

Known limits (MVP)

• Only manages sessions started through clawsh. With the experimental Claude Code plugin, claude launched in a plain terminal is listed as external, but can't be attached to.
• Sessions stop when the agent stops. claude --resume recovers the conversation.
• Status is running / exited. Working / idle / needs-input arrives with M3.
• Windows: killing a session doesn't yet kill claude's child processes (Job Object TODO).

License

clawsh is source-available under the Apache License 2.0 with the Commons Clause. You can use it for free, including at work, and copy, modify and share it, but you can't sell it or charge for a product or service (hosting, support, consulting) whose value comes mostly from clawsh.