Agent skill

Tmux

by Team-Commonly in Team-Commonly/commonly

Manage long-running shell sessions with tmux — start a detached session, run a long task, reattach later, capture output.

Apache-2.0Auto-check passedDocuments & Office

Install Tmux

skills CLI

$ npx skills add Team-Commonly/commonly --skill tmux -a claude-code

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

GitHub CLI

$ gh skill install Team-Commonly/commonly tmux --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/Team-Commonly/commonly.git skills-src && mkdir -p .claude/skills && cp -r skills-src/backend/commonly-bundled-skills/tmux .claude/skills/tmux && 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/

Paste into Claude Code

Install the "tmux" agent skill from https://github.com/Team-Commonly/commonly/tree/main/backend/commonly-bundled-skills/tmux into .claude/skills/tmux/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tmux", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/Team-Commonly/commonly/tree/main/backend/commonly-bundled-skills/tmux

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add Team-Commonly/commonly --skill tmux -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install Team-Commonly/commonly tmux --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Team-Commonly/commonly.git skills-src && mkdir -p .agents/skills && cp -r skills-src/backend/commonly-bundled-skills/tmux .agents/skills/tmux && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "tmux" agent skill from https://github.com/Team-Commonly/commonly/tree/main/backend/commonly-bundled-skills/tmux into .agents/skills/tmux/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tmux", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add Team-Commonly/commonly --skill tmux -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install Team-Commonly/commonly tmux --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Team-Commonly/commonly.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/backend/commonly-bundled-skills/tmux .cursor/skills/tmux && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "tmux" agent skill from https://github.com/Team-Commonly/commonly/tree/main/backend/commonly-bundled-skills/tmux into .cursor/skills/tmux/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tmux", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/Team-Commonly/commonly.git --path backend/commonly-bundled-skills/tmux

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add Team-Commonly/commonly --skill tmux -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install Team-Commonly/commonly tmux --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Team-Commonly/commonly.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/backend/commonly-bundled-skills/tmux .gemini/skills/tmux && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "tmux" agent skill from https://github.com/Team-Commonly/commonly/tree/main/backend/commonly-bundled-skills/tmux into .gemini/skills/tmux/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tmux", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install Team-Commonly/commonly tmux

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add Team-Commonly/commonly --skill tmux -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/Team-Commonly/commonly.git skills-src && mkdir -p .github/skills && cp -r skills-src/backend/commonly-bundled-skills/tmux .github/skills/tmux && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "tmux" agent skill from https://github.com/Team-Commonly/commonly/tree/main/backend/commonly-bundled-skills/tmux into .github/skills/tmux/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tmux", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add Team-Commonly/commonly --skill tmux -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install Team-Commonly/commonly tmux --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Team-Commonly/commonly.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/backend/commonly-bundled-skills/tmux .opencode/skills/tmux && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "tmux" agent skill from https://github.com/Team-Commonly/commonly/tree/main/backend/commonly-bundled-skills/tmux into .opencode/skills/tmux/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tmux", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: tmux
GitHub stars: 1.4k
Token cost: ~488 tokens
SKILL.md length: 113 words
Files: 1
Skills in repo: 7
Repo updated: Oct 7, 2026
First seen: Oct 7, 2026
Licence: Apache-2.0

At a glance

Manage long-running shell sessions with tmux — start a detached session, run a long task, reattach later, capture output.

A task takes longer than a single tool call (build
SKILL.md covers Start a detached session, Check on a session, Send input to a session and End a session, plus 2 more sections
Calls npm

What it does

Tmux is an agent skill from Team-Commonly/commonly. Manage long-running shell sessions with tmux — start a detached session, run a long task, reattach later, capture output. Use when a task takes longer than a single tool call (build, test, log tail).

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

It sits in Documents & Office. It works with tmux. The repository describes itself as: Open-source room for humans + cross-vendor AI agents. Every agent gets its own name, memory, skills, and workstation. Any runtime, your infra — no per-agent fees. The licence is Apache-2.0.

When your agent uses it

A task takes longer than a single tool call (build

Example prompts

“/tmux”

What it can do on your machine

Read from SKILL.md and the folder at commit e597fb4. 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:
- npm
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use npm, 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 no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Tmux loads about 488 tokens when it runs. Until then it costs about 51 tokens; SKILL.md has 113 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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 Team-Commonly/commonly at commit e597fb4, republished under its Apache-2.0 licence (© Team-Commonly). 113 words, ~488 tokens.

Download SKILL.mdSave it as .claude/skills/tmux/SKILL.md (or your agent's skills folder).

name: tmux
description: Manage long-running shell sessions with tmux — start a detached session, run a long task, reattach later, capture output. Use when a task takes longer than a single tool call (build, test, log tail).

tmux — long-running session management

tmux is on PATH in the gateway. Sessions persist across tool-call boundaries within the same agent's lifetime, so you can fire off a long task and come back to it on the next heartbeat.

Start a detached session

bash

# Run a long command in a fresh detached session named "build"
tmux new-session -d -s build "npm run build > /tmp/build.log 2>&1"

Check on a session

bash

# List sessions
tmux list-sessions

# Capture the current pane's visible output
tmux capture-pane -t build -p | tail -40

# Capture the full scrollback (last 1000 lines)
tmux capture-pane -t build -p -S -1000

Send input to a session

bash

# Send a command (note: end with C-m for Enter)
tmux send-keys -t build "echo done > /tmp/done.flag" C-m

End a session

bash

tmux kill-session -t build

Common patterns

Long-running build with status flag

bash

tmux new-session -d -s build "
  npm run build > /tmp/build.log 2>&1
  echo \$? > /tmp/build.exit
"

# Later (next heartbeat):
if [ -f /tmp/build.exit ]; then
  EXIT=\$(cat /tmp/build.exit)
  echo "Build finished with exit code \$EXIT"
  tail -20 /tmp/build.log
else
  echo "Build still running..."
fi

Tail a log without blocking

bash

tmux new-session -d -s logs "kubectl logs -f -n commonly-dev deploy/backend > /tmp/backend.log"
# Read on demand:
tail -50 /tmp/backend.log

When NOT to use tmux

For one-shot commands → run them directly with acpx_run or shell.
For tasks that need to outlive the agent's gateway pod → use a different mechanism (cron, scheduled job, etc.).
For interactive workflows → tmux works but can't take human input from inside an agent.

Files

Just SKILL.md in backend/commonly-bundled-skills/tmux of Team-Commonly/commonly.

Open the folder on GitHubat commit e597fb4

Compare with similar skills

Tmux 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.

Tmux compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Tmux this skillTeam-Commonly/commonly	1.4k	—	~488	Automated safety check: Pass	Apache-2.0	today
Tmux Bridgetmustier/pi-for-excel	434	—	~819	Automated safety check: Pass	MIT	yesterday
Math Unicodehashgraph-online/awesome-codex-plugins	1.2k	—	~4.5k	Automated safety check: Pass	Apache-2.0	yesterday
Markdown Article FormatterJimLiu/baoyu-skills	26k	6 repos	~3.5k	Automated safety check: Pass	MIT	27 days ago
MarkitdownImCa0/just-laws	781	14 repos	~3.2k	Automated safety check: Notes	MIT	8 days ago
Obsidian MarkdownAtmosphere/atmosphere	3.8k	20 repos	~1.3k	Automated safety check: Pass	Apache-2.0	yesterday

Similar skills

Tmux Bridge
tmustier/pi-for-excel
Local terminal access via the tmux bridge. An agent skill from tmustier/pi-for-excel.
434 GitHub stars~819 tokensUpdated yesterday
Documents & OfficeAuto-check passed
Math Unicode
hashgraph-online/awesome-codex-plugins
A skill your agent uses when a response needs mathematical notation (equations, filters, set-builder notation, statistics, calculus, linear algebra, logic, ratios, drops, counts) and the output goes…
1.2k GitHub stars~4.5k tokensUpdated yesterday
Documents & OfficeAuto-check passed
Markdown Article Formatter
JimLiu/baoyu-skills
Reformats plain text or Markdown articles with frontmatter, a title, a summary, headings, bold, lists and code blocks, and saves a separate formatted copy.
26k GitHub starsUsed in 6 repos~3.5k tokens
Documents & OfficeAuto-check passed
Markitdown
ImCa0/just-laws
Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.
781 GitHub starsUsed in 14 repos~3.2k tokens
Documents & OfficeAuto-check: notes
Obsidian Markdown
Atmosphere/atmosphere
Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.
3.8k GitHub starsUsed in 20 repos~1.3k tokens
Documents & OfficeAuto-check passed
DOCX
rvdbreemen/OTGW-firmware
A skill your agent uses whenever the user wants to create, read, edit, or manipulate Word documents (.docx files).
207 GitHub starsUsed in 33 repos~4.3k tokens
Documents & OfficeAuto-check passed

More from Team-Commonly/commonly

Commonly
Team-Commonly/commonly
You are a member of a Commonly workspace — a shared space where humans and AI agents from any origin collaborate in pods (chat rooms with memory).
1.4k GitHub stars~2.9k tokensUpdated today
Auto-check passed
GitHub
Team-Commonly/commonly
Interact with GitHub (issues, PRs, repos, releases) using the gh CLI.
1.4k GitHub stars~857 tokensUpdated today
Auto-check passed
Markdown Converter
Team-Commonly/commonly
Convert binary documents (PDF, DOCX, XLSX, PPTX, HTML, EPUB, images) to clean LLM-friendly Markdown using Microsoft's markitdown Python tool.
1.4k GitHub stars~557 tokensUpdated today
Auto-check passed
Officecli Commonly Templates
Team-Commonly/commonly
A skill your agent uses when producing a polished, Commonly-branded deliverable (.docx brief / memo, .xlsx data matrix, .pptx deck) and you do not have specific brand guidance from the user.
1.4k GitHub stars~1.7k tokensUpdated today
Auto-check passed
Pandic Office
Team-Commonly/commonly
Convert Markdown to PDF (or DOCX/EPUB/HTML) using the pandoc CLI.
1.4k GitHub stars~642 tokensUpdated today
Auto-check passed
PDF
Team-Commonly/commonly
Manipulate PDF files — extract text, count pages, render thumbnails, merge or split documents.
1.4k GitHub stars~572 tokensUpdated today
Auto-check passed

Works with

tmux

Questions about Tmux

What does Tmux do?

Manage long-running shell sessions with tmux — start a detached session, run a long task, reattach later, capture output. Tmux is an agent skill from Team-Commonly/commonly. Manage long-running shell sessions with tmux — start a detached session, run a long task, reattach later, capture output.

When should I use Tmux?

Tmux fits situations like: A task takes longer than a single tool call (build.

How do I install Tmux in Claude Code?

Run `npx skills add Team-Commonly/commonly --skill tmux -a claude-code`. Or copy the skill folder (backend/commonly-bundled-skills/tmux in Team-Commonly/commonly) into .claude/skills/tmux in your project. Claude Code loads it when a task matches its description.

How do I install Tmux in Codex?

Run `npx skills add Team-Commonly/commonly --skill tmux -a codex`. Or copy the skill folder (backend/commonly-bundled-skills/tmux in Team-Commonly/commonly) into .agents/skills/tmux in your project. Codex loads it when a task matches its description.

Can I use Tmux 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 Team-Commonly/commonly --skill tmux -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tmux, .gemini/skills/tmux, .github/skills/tmux and .opencode/skills/tmux in your project.

What does Tmux need to run?

Going by SKILL.md and its folder, Tmux needs the command-line tools its instructions call (npm).

Does Tmux access the network?

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

Is Tmux safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Tmux use?

Tmux is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Tmux use?

About 488 tokens (SKILL.md is roughly 2k 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 Tmux?

Skills that share tags, products or a category with Tmux: Tmux Bridge (tmustier/pi-for-excel, 434 stars), Math Unicode (hashgraph-online/awesome-codex-plugins, 1.2k stars), Markdown Article Formatter (JimLiu/baoyu-skills, 26k stars) and Markitdown (ImCa0/just-laws, 781 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tmux?

Team-Commonly (a GitHub organization) maintains it in Team-Commonly/commonly, which has 1,359 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 7, 2026.

Source: Team-Commonly/commonly on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Tmux

Facts

At a glance

What it does

When your agent uses it

Example prompts

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

tmux — long-running session management

Start a detached session

Check on a session

Send input to a session

End a session

Common patterns

Long-running build with status flag

Tail a log without blocking

When NOT to use tmux

Files

Compare with similar skills

Similar skills

More from Team-Commonly/commonly

Related

Questions about Tmux