How to share a Claude Code session from your phone
Share a running (or inactive) session with someone you trust so they can follow along or help — without copy/pasting transcripts.
- CLI
- 0.1.0
- Preview ref
- f36aa45
I kept wanting a very simple thing:
I’m in the middle of a Claude Code session, and I want to show it to someone I trust — either because I want help, or because I want to hand off context.
What I didn’t want was:
- copy/paste chunks of transcript into chat
- screen-record a terminal
- or forward a pile of logs that nobody can navigate
So I tried the thing that felt like it should exist: share the session.
TL;DR
- Decide what you’re sharing:
- a live session you want feedback on, or
- a session transcript you want someone to catch up on
- If you’re using Happier: set it up (or attach via Direct sessions), then open the session on your phone.
- Add the person as a friend (or connect GitHub if your server requires it).
- Share the session with that friend.
- They can open it on their device and follow along.
What I tried first (and where I bounced off)
-
Copy/paste transcript: works for one message, but it loses structure and context fast.
-
Screenshare / recording: works, but it’s hard to review later.
-
Happier: gives you a real share flow (built around friends), so the other person can navigate the same session instead of reading fragments. Trade-off: sharing depends on the Friends feature being enabled on the server.
If you’re new to Happier (what it is, and where to get it)
If you haven’t seen Happier before: it’s an open-source companion app (mobile/web/desktop) for AI coding agents like Claude Code, Codex, and OpenCode.
The workflow here is: use Happier to share and follow sessions from your phone, while the session still runs on the machine that owns the workspace.
Get set up:
- How to run Happier from your phone
- GitHub: https://github.com/happier-dev/happier
- Install/download: https://github.com/happier-dev/happier#how-it-works
- Discord (community + support): https://discord.gg/W6Pb8KuHfg
Prerequisites
- Friends/sharing must be enabled on the server.
- Depending on server config, Friends may require GitHub OAuth.
Step-by-step: share a session from your phone
1) Open Friends
Open the Friends screen.
If you don’t see it:
- Friends is disabled on this server, or
- Friends requires GitHub and OAuth isn’t configured
2) Add the person you want to share with
Use the add-friend flow.
Once they accept, they show up in your friends list.
3) Share the session
Open the session you want to share.
Use the session share action to share it with that friend.
4) What the other person sees
They’ll be able to open the session from their device and follow the same transcript and context.
Troubleshooting
Symptom: I don’t see Friends anywhere
Likely causes:
- Friends is disabled (
features.social.friends.enabled=false) - Friends requires GitHub but OAuth isn’t configured
Fix:
- enable Friends on the server, and configure OAuth if required
FAQ
Is this like sharing a link?
It’s closer to sharing access than sending a static link. The point is that the other person can navigate the session, not just read a snapshot.