Repository navigation
Releases
v0.3.0
A session can now move itself with a slash command: /hc-teleport <machine> in Claude Code, Codex, OpenCode and Pi runs hc-teleport <machine> --detach and ends the agent's turn, so the session moves once it is idle. The CLI itself is unchanged from v0.2.0.
Changes
- Claude Code: add the marketplace with
/plugin marketplace add ejklock/hc-teleport, then installhc-teleport@hc-teleport. The command is/hc-teleport, because Claude Code's built-in/teleporthandles cloud sessions. - Codex:
codex plugin marketplace add ejklock/hc-teleport, thencodex plugin add hc-teleport@hc-teleport. Codex gets the skill. - OpenCode and Pi: the npm package
hc-teleport-agentadds the/hc-teleportcommand and the skill (OpenCode through its plugin config hook, Pi through a prompt template). - Claude Code sessions only, for now: the CLI moves Claude Code sessions. In another agent's session the command reports
not_claude, and the agent tells the person that its sessions cannot move yet. - What the agent is told: run the command once and end the turn without waiting; on
not_initialized, ask the person to runhc-teleport initin a terminal; with no machine named, offer the machineshc-teleport doctorlists.
Requirements
hc-teleport v0.3.0 (or v0.2.0) on the PATH, a config written by hc-teleport init, Node 26 and hc. See the README's Plugins section.
v0.2.0
A coding-agent session can now move itself: from inside a Claude Code session in an hc terminal, hc-teleport <machine> --detach hands the move to a runner terminal and returns at once. This release also requires a one-time setup, and adds moves between machines that share a disk.
Breaking change
- Run
hc-teleport initonce. Every move and--dry-runnow refusesnot_initializeduntilhc-teleport inithas stored which machines may receive a session (~/.config/hc-teleport/config.json). A destination outside that list refusesmachine_not_allowed.
Changes
- Move a session from inside it:
hc-teleport <machine> --detach [--wait <s>]starts a runner terminal namedhct-<session>on the core, which waits for the session to be idle and then moves it. A second--detachfor the same session refusesmove_in_progress. When the move fails and the session still runs, the runner typeshc-teleport: <phase> (<reason>); see hc-teleport statusinto it. - See detached moves:
hc-teleport status [--json]lists each detached move with its start time, phase and runner, and marksrunner_lostwhen the runner died. - Choose and check machines:
hc-teleport initis an interactive wizard.hc-teleport doctor [--json]checks thathcreaches each allowed machine and thatclaude --versionruns there. - Relocate on one disk: when the source and destination share the session's disk (same device and inode of the transcript), the move copies nothing. It stops the source, then resumes on the destination, and resumes on the source again if the destination does not come up. Two
hcmachines on one disk may move directly.--dry-run --jsonreports"relocate": true|false. - Real sessions are recognized: a session started by herdr-wake or by a wrapper such as
claude-klockis found from the terminal'swakelabel, checked against Claude Code's pid registry, and resumed with its own profile (env CLAUDE_CONFIG_DIR=…). v0.1.0 refused these sessions asnot_claude. - Fixes: a failed put-back of the transcript is reported;
hc getgets--before the address; the test bed no longer fails on an unread stdin.
Requirements
Node 26 and hc on the PATH. See the README for usage, output, refusals and exit codes.
v0.1.0
The first release of hc-teleport: it moves a Claude Code session that runs in an hc terminal from the Mac to another hc machine, and back.
Changes
- Move a session:
hc-teleport <terminal> <machine>plans the move, checks the destination (preflight), carries the git checkout and the transcript, resumes the session in a new terminal on the destination, then stops the source terminal and parks its checkout. A refusal before the first write changes nothing; a destination that does not come up is rolled back. - The way back:
hc-teleport dev-home/<t> localbrings a session from anhcmachine back to the Mac with the same flow. - Plan only:
--dry-runprints what a move would resume and writes nothing;--jsonprints one JSON object. - Resume as it ran: the destination runs the same launcher (such as
claude-klock) with its allowed flags and--resume <id>; an unknown flag refuses and is named.
Requirements
Node 26 and hc on the PATH, on the Mac. See the README for usage, output and exit codes.