A few times a week I'm deep in a Claude Code session and someone who isn't a developer wants to ask it something. A client wants to know why the invoice totals changed. A teammate in product wants to ask what a migration will touch. The session already has all the context. The person asking has none of the tools.
Every option I tried asked them to install an app or sign in to something. So I wrote a small CLI that asks them for a browser instead.
What it does
npx guestpass start --password pick-one
# Link: https://random-words.trycloudflare.com/r/aqJYeCwPBOKKjB9a
You send the link. The other person opens it on a phone or laptop and types a question. The question goes to the session that's already running on your computer, and the answer comes back on the page.
How it's wired
Guest's browser -> Cloudflare quick tunnel -> GuestPass on your computer -> your agent session
- A local daemon serves one page and holds the guest's messages. Nothing runs on a server of mine.
-
A Cloudflare quick tunnel gives that local page a public
trycloudflare.comaddress. No Cloudflare account is needed, andcloudflaredis downloaded on first use if it isn't installed. -
Two commands connect the agent.
guestpass waitblocks until a guest writes, prints the message and exits.guestpass say "..."posts the agent's answer to the page. An agent that can run shell commands can loop on those two. For Claude Code the page also mirrors the session itself, so the guest sees the conversation and what the agent is doing right now. -
It installs as a skill or a plugin, so you can just tell the agent "share this session" and it starts, listens and replies on its own:
npx skills add fengyiqicoder/guestpass.
It has zero dependencies and needs Node 18+.
The part to be careful about
A guest can ask the agent to do anything the agent can do on your computer: files, shell, logins. So:
- set a password with
--password; - send the link only to people you trust;
- remember the page shows the last 20 messages, so don't share a session that just printed a key.
The link is temporary. It changes every time you start and dies when your computer sleeps. Read-only and ask-first guest modes are next on the list.
Try it
Repo, demo GIF and a 60-second video: https://github.com/fengyiqicoder/guestpass (MIT).
It's tested end to end with Claude Code. Codex, Gemini CLI, Cursor and OpenCode are detected but not yet tested end to end, so if you try one of those I'd like to hear how it went.
Who would you hand a link like this to?
I wrote this post with help from an AI assistant and checked every command against the repo.
Top comments (0)