aegis-systemsv1

Terminal Handoff — Development skill for Claude Code

Development community

Persistent Claude Code session handoff and secure remote control from authorised devices, with automatic continuation, durable instructions, ownership enforcement, STOP/resume and private Tailscale ac.

How to install Terminal Handoff

This entry records only its repository, not the path inside it, so there is no exact command to give. Open aegis-systemsv1/terminal-handoff and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Terminal Handoff does

Alternatives in Development

Epic Claim — Claim an epic issue, stamp coordination state, and sync local ownership 243.5k ★
Claude Supermemory — Persistent memory across sessions and projects using Supermemory 2.3k ★
Herdrm — Native macOS console for herdr — all your coding agents and their live terminals, across devices 635 ★

README

Terminal Handoff

**A persistent session-control and handoff system for Claude Code on macOS.**

Terminal Handoff lets one Claude Code *task* outlive any single Claude session. When a session fills its context window, ownership of the task is transferred automatically to a fresh successor that continues the same work. The task is also securely controllable from an enrolled iPhone (or another authorised device) over a private Tailscale network, while the actual Claude Code process keeps running on your Mac, inside a project you registered, under your own Claude login.

The idea that ties it together: a **logical session** is the persistent thing (its ID, name, project, instruction queue, STOP state, approvals and history), and individual Claude processes are **replaceable workers** underneath it. A phone talks to the logical session, never to a process, so it keeps controlling the right worker across every handoff.

**Version 1.4.0.** Physical iPhone acceptance was completed on 2026-09-20. See [Acceptance evidence](#acceptance-evidence) and [Known limitations](#known-limitations).

[What it can do](#what-terminal-handoff-can-do) · [Architecture](#architecture) · [Session lifecycle](#remote-session-lifecycle) · [Automatic handoff](#automatic-handoff) · [Control from an iPhone](#remote-control-from-iphone) · [Security model](#security-model) · [Projects](#project-registration) · [Naming](#session-naming) · [STOP / resume](#stop--resume) · [Approval gates](#human-approval-gates) · [Recovery](#recovery) · [Install and set up](#installation-and-setup) · [CLI reference](#cli-reference) · [Acceptance evidence](#acceptance-evidence) · [Limitations](#known-limitations) · [Troubleshooting](#troubleshooting) · [Local handoff in detail](#local-handoff-in-detail)