Carryon — AI skill for Claude Code

carryon

Carries an AI coding agent's working life between machines: the Setup that makes an agent yours — settings, skills, subagents, instructions, plugin lists — and the History of what you did with it.

The two halves have opposite safety properties. A Setup travels plaintext, and carryon refuses to produce one when a credential pattern matches, when the capture set reads carryon's own state or anything outside `$HOME`, or when it cannot tell whether it read its own state. That is a scan and a boundary rather than a proof — an opaque token matches no pattern — and a Setup is personal whether or not it holds a secret, so it belongs in private storage. A History is unredacted by nature: it is always encrypted, and a credential found there is reported and carried, never redacted or blocked.

Supports Claude Code, Codex CLI, Cursor, and the `~/.agents` skills convention; a History moves for Claude Code and Codex, the two whose session layout the engine knows. No Python dependencies — encryption shells out to the `openssl` already on the machine — and Python 3.9+. Run on macOS only, so far.

This file is an index. The vocabulary is defined in [CONTEXT.md](CONTEXT.md) and the reasoning behind each decision in [docs/adr/](docs/adr/).

Install

uv tool install git+https://github.com/MarShaikh/carryon
pip install git+https://github.com/MarShaikh/carryon

Commands

Command	Effect
init	set up this machine: Destination, recovery key, config. In a terminal it asks where the Archive should live; --dest SPEC says so outright, and --join CODE pairs with an existing Archive instead
push	push this machine's Snapshot: the Setup plaintext, the History encrypted, changed Sessions only — never one the Archive is ahead on
pull	lay the Archive down here: union the History, replace the Setup after a backup
sync	carry the History both ways in one pass: pull what the Archive has, then push what it lacks — pull first