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.

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗