teleport-tmux

teleport-tmux is a command for Claude Code from sjungling/sjungling-claude-plugins. It costs 18 tokens per session (1,111 once invoked), scanned A, original, MIT.

A command that prepares the current Claude conversation to continue in a new tmux window. Tmux is a terminal tool that keeps command-line sessions available after the original terminal closes.

In plain words
What is it for?
Use it to move a Claude session into tmux when you need to close or replace the current terminal.
Why use it?
It lets you close the terminal where the conversation started while preserving the saved conversation for a later resume. Work that was still running may not transfer.

Command for Claude Code

Written for Claude Code: allowed-tools in frontmatter. Also seen: names the AskUserQuestion tool.

Runs only inside its plugin — its command needs a path that Claude Code sets for a plugin’s own hooks and for nothing else. Install the plugin, not this.

Part of the workflow plugin — 10 commands, 1 agent shipped together

Good fit Use it to move a Claude session into tmux when you need to close or replace the current terminal.

Compare 6 commands from other repositories ↓
Install

Getting it into your agent

This one installs as part of its plugin. Adding the marketplace and installing the plugin brings it with everything else the plugin ships.

Claude Code
/plugin marketplace add sjungling/sjungling-claude-plugins
Claude Code
/plugin install workflow

Made for: Claude Code.

Or install workflow, the plugin that ships this one along with the rest of its 10 commands, 1 agent.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for teleport-tmux

README.md
[![agentmods](https://agentmods.dev/badge/commands/sjungling/sjungling-claude-plugins/teleport-tmux/github.svg)](https://agentmods.dev/commands/sjungling/sjungling-claude-plugins/teleport-tmux)
Your own site
<a href="https://agentmods.dev/commands/sjungling/sjungling-claude-plugins/teleport-tmux"><img src="https://agentmods.dev/badge/commands/sjungling/sjungling-claude-plugins/teleport-tmux/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for teleport-tmux

Your own site · 80×15
<a href="https://agentmods.dev/commands/sjungling/sjungling-claude-plugins/teleport-tmux"><img src="https://agentmods.dev/badge/commands/sjungling/sjungling-claude-plugins/teleport-tmux.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 18 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,111 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00018 $0.01111
Opus 5 $0.00009 $0.00556
Sonnet 5 $0.00004 $0.00222
Haiku 4.5 $0.00002 $0.00111

Measured 11d ago against content hash 7e8c19736afc, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

teleport-tmux scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/workflow/commands/teleport-tmux.md · 99 lines

How it starts

The opening of the file, as written. The whole thing — 99 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Teleport this Claude conversation into a tmux window so the user can close the terminal they accidentally started Claude in without losing the session.

macOS cannot move a live process's controlling terminal (no working reptyr), so this does NOT move the running process. Instead it arms a new tmux window to resume the current conversation from disk (claude --resume <session-id>) the moment the old process exits. The conversation transcript is persisted per turn, so everything committed transfers; only truly in-flight work is lost.

All the real work lives in ${CLAUDE_PLUGIN_ROOT}/scripts/teleport-tmux.sh. This command just runs it in two phases and relays the result.

IMPORTANT — run every bash block in this command with the sandbox DISABLED (dangerouslyDisableSandbox: true). tmux talks to its server over a Unix socket (e.g. /private/tmp/tmux-501/default) that lives outside the default sandbox's writable allowlist. Under the sandbox, tmux list-sessions, new-window, and send-keys all fail with error connecting to … (Operation not permitted). The script surfaces this as ERROR_LISTING_SESSIONS instead of silently hiding sessions — but it still cannot create the window unless the sandbox is off. The command -v tmux check passes either way (the binary exists), so the failure is easy to miss. Disable the sandbox up front.

Follow this workflow exactly.

Step 1: Discover state

Run this (sandbox disabled) and read its output:

bash "${CLAUDE_PLUGIN_ROOT}/scripts/teleport-tmux.sh" --discover

Capture from the output:

  • RESUME_SCRIPT — path passed to --arm in Step 3.
  • AUTOyes if the old claude PID was detected, no otherwise.
  • INSIDE_TMUXyes if we're already inside tmux.
  • The session list under --- existing tmux sessions ---.

If you see ERROR_LISTING_SESSIONS, the sandbox is still on (or the tmux socket is otherwise blocked). Re-run the command with the sandbox disabled before continuing — do NOT treat it as "no sessions."

Read the full file on GitHub · 99 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 11d ago First seen · 99 lines · 18 tokens per session scan A 7e8c19736afc

Subscribe to this mod's changes

teleport-tmux is a command published in the GitHub repository sjungling/sjungling-claude-plugins (13 stars, last pushed 28d ago), licensed MIT. It adds 18 tokens to every session and 1,111 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.