Agent skill

Parcel

by 0xSero in 0xSero/parcels

Ship the current work — repo, uncommitted changes, .env files, and the live agent session — to another machine over Tailscale SSH, where the agent resumes in tmux and keeps working.

MITAuto-check: notes

Install Parcel

skills CLI
$ npx skills add 0xSero/parcels --skill parcel -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install 0xSero/parcels parcel --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/0xSero/parcels.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/parcel .claude/skills/parcel && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
parcel
GitHub stars
175
Token cost
~740 tokens
SKILL.md length
343 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Ship the current work — repo, uncommitted changes, .env files, and the live agent session — to another machine over Tailscale SSH, where the agent resumes in tmux and keeps working.

  • Works in 4 steps: Write intent into HANDOFF.md at the repo… → Ship. From inside the repo → Verify it is actually running — never… → …
  • The user says /parcel
  • SKILL.md covers Workflow, Fixing missing auth (from… and Notes
  • Calls claude, codex and ssh; needs CLAUDE_CODE_OAUTH_TOKEN and XAI_API_KEY

What it does

Parcel is an agent skill from 0xSero/parcels. Ship the current work — repo, uncommitted changes, .env files, and the live agent session — to another machine over Tailscale SSH, where the agent resumes in tmux and keeps working. Use when the user says /parcel, "hand off to <machine", "send this work to another machine", "keep this running after I close the laptop", or wants to move a coding session (Claude Code, Codex, pi, Droid, or Grok Build) to a remote box.

Its SKILL.md is about 740 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with tmux. The repository describes itself as: Ship your repo + live coding-agent session (Claude Code / Codex / pi / Droid) to another machine over Tailscale; it resumes in tmux and keeps working. The licence is MIT.

When your agent uses it

  • The user says /parcel
  • Hand off to <machine
  • Send this work to another machine
  • Keep this running after I close the laptop

Example prompts

  • “hand off to <machine”
  • “send this work to another machine”
  • “keep this running after I close the laptop”
  • “/parcel”

Requirements

  • A credential in CLAUDE_CODE_OAUTH_TOKEN
  • A credential in XAI_API_KEY

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Write intent into HANDOFF.md at the repo root before shipping. This is
  2. Ship. From inside the repo
  3. Verify it is actually running — never assume. parcel status
  4. Tell the user how to reach it

What it can do on your machine

Read from SKILL.md and the folder at commit 7b23c72. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • claude
    • codex
    • ssh

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use ssh, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • CLAUDE_CODE_OAUTH_TOKEN
    • XAI_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Parcel loads about 740 tokens when it runs. Until then it costs about 107 tokens; SKILL.md has 343 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~107
When it runs · the whole SKILL.md, loaded when a task matches
~740

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:3
    urrent work — repo, uncommitted changes, .env files, and the live agent session — to another machine over Tailscale SSH,
  • NoteMentions a .env fileSKILL.md:60
    e ships — including untracked files and `.env`s — so

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from 0xSero/parcels at commit 7b23c72, republished under its MIT licence (© 0xSero). 343 words, ~740 tokens.

Download SKILL.mdSave it as .claude/skills/parcel/SKILL.md (or your agent's skills folder).
name
parcel
description
Ship the current work — repo, uncommitted changes, .env files, and the live agent session — to another machine over Tailscale SSH, where the agent resumes in tmux and keeps working. Use when the user says /parcel, "hand off to <machine>", "send this work to another machine", "keep this running after I close the laptop", or wants to move a coding session (Claude Code, Codex, pi, Droid, or Grok Build) to a remote box.
license
MIT

Parcel — hand off work to another machine

The parcel CLI is on PATH. Targets are machines defined in ~/.parcels/targets/<name>.conf; list them with parcel targets.

Workflow

  1. Write intent into HANDOFF.md at the repo root before shipping. This is the most valuable part of the handoff — the remote agent (possibly a different one) reads it first. Include:

    • what you were working on and why
    • current state (what works, what's verified, what's mid-flight)
    • concrete next steps, in order
    • known gotchas and how to verify progress

    Preserve any existing ## Machine state (auto-generated by parcel section — parcel regenerates it on every send.

  2. Ship. From inside the repo:

    parcel send <target> --agent <claude|codex|pi|droid|grok> [--session <id>]
    • If you are Claude Code, your session id is the UUID in your scratchpad path (.../<uuid>/scratchpad). If you are Grok Build, it is the session directory name under ~/.grok/sessions/<encoded-cwd>/<uuid>/. If unsure, omit --session — parcel picks the newest session for this cwd.
    • --agent grok (alias: grok-build) transplants a Grok Build session.
    • --prompt "..." steers what the remote agent does first (default: read HANDOFF.md and continue).
    • --idle ships without launching anything.
  3. Verify it is actually running — never assume. parcel status <target> tails the remote tmux pane; you should see the agent producing output. If the launch failed, run parcel doctor <target> and report exactly what is missing.

  4. Tell the user how to reach it: ssh -t <host> tmux attach -t parcel-<repo-name>.

Show full SKILL.md (119 more words)Show less

Fixing missing auth (from parcel doctor)

  • claude — user runs claude login once on the target, or mints a token on an authed machine with claude setup-token and sets CLAUDE_CODE_OAUTH_TOKEN in the target's shell profile.
  • codex / pi / grok — parcel auth <target> copies the credential files. Grok alternative: set XAI_API_KEY on the target, or run grok login.
  • droid — user runs droid once on the target to log in.

Notes

  • Only git repos can be parceled (parcel send runs from inside the repo).
  • The whole working tree ships — including untracked files and .envs — so warn the user before sending a repo with secrets to a shared machine.
  • Re-sending the same repo overwrites the remote copy (rsync --delete) and restarts the tmux session.

© 0xSero, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/parcel of 0xSero/parcels.

Open the folder on GitHubat commit 7b23c72

Compare with similar skills

Parcel next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Parcel compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Parcel this skill0xSero/parcels175—~740Automated safety check: NotesMIT
Codex Plugin QAcode-yeongyu/oh-my-openagent70k1 repos~1.9kAutomated safety check: PassCustom licence
Tmuxopenclaw/openclaw392k2 repos~640Automated safety check: PassMIT
1passwordtrpc-group/trpc-agent-go1.8k15 repos~656Automated safety check: PassApache-2.0
CodeGraph Agent Evalcolbymchenry/codegraph73k—~950Automated safety check: PassMIT
Tmuxtrpc-group/trpc-agent-go1.8k24 repos~868Automated safety check: PassApache-2.0

Similar skills

  • Codex Plugin QA

    code-yeongyu/oh-my-openagent

    Tests the omo Codex plugin in an isolated CODEX_HOME with a local mock model, proving hooks fired through app-server notifications without touching ~/.codex.

    70k GitHub starsUsed in 1 repo~1.9k tokens
    Testing & QAAuto-check passed
  • Tmux

    openclaw/openclaw

    Control tmux sessions/panes for interactive CLIs: list, capture output, send keys, paste text, monitor prompts.

    392k GitHub starsUsed in 2 repos~640 tokens
    Auto-check passed
  • 1password

    trpc-group/trpc-agent-go

    Set up and use 1Password CLI (op). An agent skill from trpc-group/trpc-agent-go.

    1.8k GitHub starsUsed in 15 repos~656 tokens
    AI & LLM EngineeringAuto-check passed
  • CodeGraph Agent Eval

    colbymchenry/codegraph

    Benchmarks how much CodeGraph helps a coding agent on a real repository, comparing runs with and without it for a chosen local or published version.

    73k GitHub stars~950 tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Tmux

    trpc-group/trpc-agent-go

    Remote-control tmux sessions for interactive CLIs by sending keystrokes and scraping pane output.

    1.8k GitHub starsUsed in 24 repos~868 tokens
    Data & AnalyticsAuto-check passed
  • CodexBar Live QA

    steipete/CodexBar

    Runs live QA for the CodexBar app: provider usage matrix checks through its packaged CLI, config validation and menu checks, with 1Password-backed credentials handled safely.

    22k GitHub stars~1.2k tokensUpdated today
    Testing & QAAuto-check passed

Works with

Questions about Parcel

What does Parcel do?

Ship the current work — repo, uncommitted changes, .env files, and the live agent session — to another machine over Tailscale SSH, where the agent resumes in tmux and keeps working. Parcel is an agent skill from 0xSero/parcels.env files, and the live agent session — to another machine over Tailscale SSH, where the agent resumes in tmux and keeps working.

When should I use Parcel?

Parcel fits situations like: the user says /parcel; hand off to <machine; send this work to another machine; keep this running after I close the laptop.

How do I install Parcel in Claude Code?

Run `npx skills add 0xSero/parcels --skill parcel -a claude-code`. Or copy the skill folder (skills/parcel in 0xSero/parcels) into .claude/skills/parcel in your project. Claude Code loads it when a task matches its description.

How do I install Parcel in Codex?

Run `npx skills add 0xSero/parcels --skill parcel -a codex`. Or copy the skill folder (skills/parcel in 0xSero/parcels) into .agents/skills/parcel in your project. Codex loads it when a task matches its description.

Can I use Parcel in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add 0xSero/parcels --skill parcel -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/parcel, .gemini/skills/parcel, .github/skills/parcel and .opencode/skills/parcel in your project.

What does Parcel need to run?

Going by SKILL.md and its folder, Parcel needs the command-line tools its instructions call (claude, codex and ssh) and credentials named CLAUDE_CODE_OAUTH_TOKEN and XAI_API_KEY. Our summary lists: A credential in CLAUDE_CODE_OAUTH_TOKEN; A credential in XAI_API_KEY.

Does Parcel access the network?

SKILL.md contains no URLs. Its commands use ssh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Parcel safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Parcel use?

Parcel is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Parcel use?

About 740 tokens (SKILL.md is roughly 3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Parcel?

Skills that share tags, products or a category with Parcel: Codex Plugin QA (code-yeongyu/oh-my-openagent, 70k stars), Tmux (openclaw/openclaw, 392k stars), 1password (trpc-group/trpc-agent-go, 1.8k stars) and CodeGraph Agent Eval (colbymchenry/codegraph, 73k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Parcel?

0xSero (a GitHub user) maintains it in 0xSero/parcels, which has 175 GitHub stars. The repository was last updated on September 3, 2026.

Source: 0xSero/parcels on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.