tmux

tmux is a skill for Claude Code, Codex from eobarretooo/ClawLite. It costs 22 tokens per session (729 once invoked), scanned A, original, MIT.

A guide for controlling tmux sessions, which keep terminal programs running in named windows that can be inspected remotely.

In plain words
What is it for?
Use it to start interactive command-line programs, find their sessions, capture output, and wait for a prompt or completion message.
Why use it?
It lets an agent send keystrokes and read terminal output when a command needs an interactive terminal instead of a simple background process.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/eobarretooo/clawlite/tmux
Any agent
npx skills add eobarretooo/ClawLite --skill tmux
Clone the repo
git clone --depth 1 https://github.com/eobarretooo/ClawLite

Made for: Claude Code, Codex.

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 tmux

README.md
[![agentmods](https://agentmods.dev/badge/skills/eobarretooo/clawlite/tmux.svg)](https://agentmods.dev/skills/eobarretooo/clawlite/tmux)
Your own site
<a href="https://agentmods.dev/skills/eobarretooo/clawlite/tmux"><img src="https://agentmods.dev/badge/skills/eobarretooo/clawlite/tmux.svg" alt="Measured on agentmods" height="20"></a>
Per session 22 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 729 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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 $0.00022 $0.00729
Opus 5 $0.00011 $0.00365
Sonnet 5 $0.00004 $0.00146
Haiku 4.5 $0.00002 $0.00073

Measured 4d ago against content hash 963de1d594ab, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

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 4d ago.

The scan reads SKILL.md. This mod also ships 2 executable files (scripts/find-sessions.sh, scripts/wait-for-text.sh), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

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.

clawlite/skills/tmux/SKILL.md · 82 lines

How it starts

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

tmux

Use tmux only when an interactive TTY is required. Prefer exec background mode for non-interactive long jobs.

Socket convention

SOCKET_DIR="${CLAWLITE_TMUX_SOCKET_DIR:-${TMPDIR:-/tmp}/clawlite-tmux-sockets}"
mkdir -p "$SOCKET_DIR"
SOCKET="$SOCKET_DIR/clawlite.sock"
SESSION=clawlite-shell

tmux -S "$SOCKET" new -d -s "$SESSION" -n shell
tmux -S "$SOCKET" send-keys -t "$SESSION":0.0 -- 'PYTHON_BASIC_REPL=1 python3 -q' Enter
tmux -S "$SOCKET" capture-pane -p -J -t "$SESSION":0.0 -S -200

Keep one socket per workflow or agent. That makes discovery, retries, and cleanup deterministic.

Finding sessions

Inspect one socket directly:

bash clawlite/skills/tmux/scripts/find-sessions.sh -S "$SOCKET"

Scan every socket under CLAWLITE_TMUX_SOCKET_DIR:

bash clawlite/skills/tmux/scripts/find-sessions.sh --all

The output is always socket:session, one row per line.

Watching output

Wait for a prompt or completion marker:

bash clawlite/skills/tmux/scripts/wait-for-text.sh -S "$SOCKET" -t "$SESSION":0.0 -p '\$' -T 5

Use fixed-string mode when the marker should not be treated as regex:

bash clawlite/skills/tmux/scripts/wait-for-text.sh -S "$SOCKET" -t "$SESSION":0.0 -F 'BUILD SUCCESS' -T 30 -i 1 -l 400

Orchestrating Coding Agents

Create a dedicated socket and session per agent:

SOCKET="$SOCKET_DIR/agent-1.sock"
SESSION=agent-1

tmux -S "$SOCKET" new -d -s "$SESSION" -n shell
tmux -S "$SOCKET" send-keys -t "$SESSION":0.0 -l -- "pytest -q"
tmux -S "$SOCKET" send-keys -t "$SESSION":0.0 Enter
bash clawlite/skills/tmux/scripts/wait-for-text.sh -S "$SOCKET" -t "$SESSION":0.0 -p 'passed|failed' -T 120 -l 500

Prefer send-keys -l for literal commands, then send Enter separately. Capture pane history before reusing or tearing down a session.

Cleanup complete

Stop a single session:

tmux -S "$SOCKET" kill-session -t "$SESSION"

Stop the whole socket server when nothing else should remain:

tmux -S "$SOCKET" kill-server

Read the full file on GitHub · 82 lines

Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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. 4d ago First seen · 82 lines · 22 tokens per session scan A 963de1d594ab

Subscribe to this mod's changes

tmux is a skill published in the GitHub repository eobarretooo/ClawLite (49 stars, last pushed 2mo ago), licensed MIT. It adds 22 tokens to every session and 729 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.

Related

Other skills, from other repositories

a0-create-agent

Create a new Agent Zero agent profile (subordinate). Covers where profiles live (user / plugin-distributed / project-scoped), the agent.yaml schema, the prompt inheritance & override model, and optional profile-specific tools and extensions. Use for any "create/add/new agent profile" request.

agent0ai/agent-zero · 63 tokens

a0-create-plugin

Create, extend, or modify Agent Zero plugins. Follows strict full-stack conventions (usr/plugins, plugin.yaml, Store Gating, AgentContext, plugin settings). Use for UI hooks, API handlers, lifecycle extensions, or plugin settings UI.

agent0ai/agent-zero · 54 tokens

linux-desktop

Use only for Agent Zero's built-in Docker/Xpra Linux Desktop, XFCE apps, LibreOffice GUI apps, file manager, terminal, or visual workflows inside the Agent Zero runtime. Not for A0 CLI /computer-use or computeruseremote host control.

agent0ai/agent-zero · 56 tokens

a0-contribute-plugin

Guide for publishing an Agent Zero plugin to the community Plugin Index (a0-plugins repo). Covers GitHub repo setup, index.yaml creation, CI validation rules, and PR submission. Use when the user wants to share, publish, submit, or contribute a plugin to the Plugin Hub so other Agent Zero users can find and install it.

agent0ai/agent-zero · 74 tokens

a0-review-plugin

Full audit of Agent Zero plugins in usr/plugins/. Reviews manifest validity, directory structure, code patterns (Store Gating, notifications, imports), security, and duplicate detection against the community index. Use when asked to review, audit, validate, or check an existing plugin before using or contributing it.

agent0ai/agent-zero · 64 tokens

host-computer-use-linux

Backend-specific Linux guidance for computeruseremote. Load after status or startsession reports backendfamily linux, backendid wayland, or AT-SPI features. Covers AT-SPI structural targeting, Wayland portal caveats, and screenshot verification.

agent0ai/agent-zero · 61 tokens