Skyhop
Skyhop is a Claude Code plugin that hands off a running terminal session to a cloud session. Run /skyhop, close your laptop, and carry on from claude.ai/code or the Claude app.
Public beta. Skyhop works end to end on macOS and Windows, and every release passes a real round trip through the cloud first. It does rely on Claude Code behaviour that isn't documented and can change with an update. If something goes wrong, please open an issue as described in Reporting a problem. Skyhop is an independent plugin, not made by Anthropic.
The problem
Claude Code has no terminal command that pushes a running session up to the cloud:
| Option | What it does | Why it isn't enough |
|---|
claude --teleport | Pulls a cloud session down to your terminal | Only goes one way |
claude --cloud | Starts a new cloud session | Doesn't carry over your conversation |
| Remote Control | Lets you steer a local session from your phone | Your computer has to stay on |
| Desktop app Open in > Cloud | Sends a session to the cloud | Carries the conversation as a summary, and needs manual clicks |
If you have to leave mid-task and shut your laptop, the cloud session starts without what you and Claude have done so far.
Install
/plugin marketplace add skyhophq/skyhop
/plugin install skyhop@skyhop
Skyhop needs Node.js 20 or later, git, and a claude.ai sign-in on a plan that includes cloud sessions. It works on macOS and Windows. Its test suite also passes on Linux, but a real handoff from a Linux machine hasn't been run yet.
On Windows (from 0.11.0), Skyhop does the default handoff, a full resume synced through GitHub, and brings it home the same way. --summary and --no-sync stop before anything is sent, because Skyhop can't start those sessions on Windows. Claude Code only starts a new cloud session from a terminal, so Skyhop runs it in a hidden console window for a minute or two, and the cloud chat tells Skyhop its link through GitHub. Handoffs from a Windows PC have been tested end to end, including going back to the same cloud chat. To install or update on Windows, run the claude plugin ... form of the commands in PowerShell, because /plugin opens a menu there.
Usage
/skyhop Move this session to the cloud, with its full history
/skyhop --summary Start a new cloud session from a brief instead
/skyhop --dry-run Show the plan and first message, and do nothing else
/skyhop --name login-fix Choose the branch name
/skyhop --history 20 Show the last 20 exchanges in the cloud chat (default 50, or off)
/skyhop --new-chat Use a new cloud chat instead of this session's earlier one
/skyhop-back Bring the session home right away, from another window
/skyhop-back --dry-run Show what would come back, and change nothing
/skyhop-status List sessions in the cloud, past handoffs and leftover branches
/skyhop-status --clean Remove leftover branches that hold nothing you'd lose
| Flag | What it does |
|---|
--name X | Names the branch skyhop/X-<timestamp>. Defaults to your current branch name |
--dry-run | Pushes nothing, starts nothing, and prints the plan and first prompt |
--yes | Skips the confirmation |
--summary | Starts a new cloud session from a brief instead of moving this one. Before version 0.3.0 this was the default, and --full-resume chose the other mode. --full-resume still works |
--mode M | Sets the starting permission mode for full resume: auto (default), acceptEdits or plan |
--history N | Full resume only. How many of the session's last exchanges the cloud chat shows as real messages: 0 to 200, or off. The default is 50 |
--new-chat | Full resume only. Starts a new cloud chat even if this session already has one |
--no-sync | Full resume only. Pushes nothing to GitHub and uploads directly instead, so /skyhop-back has nothing to bring home |
--allow-secrets | Continues even though the secret scan found something |
Handoffs start by themselves from any repository you've already trusted in Claude Code. Skyhop runs --cloud from a temporary git worktree, which shares your repository's trust, and removes the worktree afterward. If you haven't trusted the repository, Skyhop prints a command to run in your own terminal, and you choose Yes, I trust this folder.
The two modes
| Summary handoff (/skyhop --summary) | Full resume (/skyhop, the default) |
|---|
| Conversation | A brief plus recent turns, written by Claude | The real session transcript, resumed inside the VM |
| Chat experience | A normal cloud session with live tool activity | Your earlier messages as real messages, then the session's replies word for word, with a progress line about every 100 seconds instead of live tool activity |
| Code travels by | A skyhop/... branch pushed to your remote | A skyhop-run/... branch, with the transcript encrypted |
| Permission mode | Set in the chat | Set at handoff, and changed by sending a message |
| Usage | Normal | Normal. If the chat falls back to a recap, each reply is generated twice |
| Coming home | claude --teleport brings a separate copy | Open the session with /resume and send a message |
Summary handoff
Skyhop snapshots your work to a new branch and starts a cloud session on it. The first prompt holds a brief: your goal, current state, decisions, remaining work, gotchas, and the last several exchanges.
The cloud session starts with that brief, not your exact history. It's a new session that has been told what happened.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
