Agent skill

Tmux Bridge

by tmustier in tmustier/pi-for-excel

Local terminal access via the tmux bridge. An agent skill from tmustier/pi-for-excel.

MITAuto-check passedDocuments & Office

Install Tmux Bridge

skills CLI
$ npx skills add tmustier/pi-for-excel --skill tmux-bridge -a claude-code

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

GitHub CLI
$ gh skill install tmustier/pi-for-excel tmux-bridge --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/tmustier/pi-for-excel.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/tmux-bridge .claude/skills/tmux-bridge && 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
tmux-bridge
GitHub stars
434
Token cost
~819 tokens
SKILL.md length
383 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

Local terminal access via the tmux bridge. An agent skill from tmustier/pi-for-excel.

  • Works in 3 steps: Start the bridge → Configure in Pi (usually not needed) → Accept the local HTTPS certificate
  • The user asks about running shell commands
  • SKILL.md covers What it does, Running pi (or other local…, How to set it up and When the bridge is not running, plus 2 more sections
  • Calls npx; needs TMUX_BRIDGE_TOKEN

What it does

Tmux Bridge is an agent skill from tmustier/pi-for-excel. Local terminal access via the tmux bridge. Use when the user asks about running shell commands, setting up the tmux bridge, or troubleshooting terminal connectivity.

Its SKILL.md is about 820 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Requires a local tmux bridge process running on the user's machine.

It sits in Documents & Office, covering Excel spreadsheets. It works with tmux and Python. The repository describes itself as: Experimental Excel sidebar agent add-in. Multi-model. Powered by Pi. The licence is MIT.

When your agent uses it

  • The user asks about running shell commands
  • Setting up the tmux bridge
  • Troubleshooting terminal connectivity

Example prompts

  • “/tmux-bridge”

Requirements

  • Python 3
  • Node.js
  • A credential in TMUX_BRIDGE_TOKEN
  • Compatibility (from SKILL.md): Requires a local tmux bridge process running on the user's machine.

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Start the bridge
  2. Configure in Pi (usually not needed)
  3. Accept the local HTTPS certificate

What it can do on your machine

Read from SKILL.md and the folder at commit a3cea8f. 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:

    • npx

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

  • Network

    No URLs in SKILL.md. Its commands use npx, 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:

    • TMUX_BRIDGE_TOKEN

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

  • Compatibility

    Requires a local tmux bridge process running on the user's machine.

    From compatibility in the SKILL.md frontmatter.

Context cost

Tmux Bridge loads about 819 tokens when it runs. Until then it costs about 44 tokens; SKILL.md has 383 words of instructions outside code blocks.

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

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 tmustier/pi-for-excel at commit a3cea8f, republished under its MIT licence (© tmustier). 383 words, ~819 tokens.

Download SKILL.mdSave it as .claude/skills/tmux-bridge/SKILL.md (or your agent's skills folder).
name
tmux-bridge
description
Local terminal access via the tmux bridge. Use when the user asks about running shell commands, setting up the tmux bridge, or troubleshooting terminal connectivity.
compatibility
Requires a local tmux bridge process running on the user's machine.
metadata.tool-name
tmux
metadata.docs
docs/tmux-bridge-contract.md

Tmux Bridge

The tmux bridge gives Pi access to a real local terminal on the user's machine. The tmux tool is always registered — it just needs the bridge process running locally to work.

What it does

When the bridge is running, the tmux tool can:

  • list_sessions — see active tmux sessions
  • create_session — start a new shell session (optionally in a specific directory)
  • send_keys — type commands into a session
  • capture_pane — read terminal output
  • send_and_capture — send a command and wait for output in one call
  • kill_session — close a session

Running pi (or other local CLIs) via tmux

The tmux pane is a normal local shell. If pi is installed, you can invoke it directly with send_keys/send_and_capture text like any other command.

Recommended flow:

  1. list_sessions then create_session (or reuse an existing session)
  2. Optional one-time check: command -v pi
  3. Send the pi ... command
  4. Monitor output with capture_pane

For long-running jobs, avoid rapid repeated captures. Prefer:

  • capture_pane with wait_ms (for example 15000-30000), or
  • send_and_capture with wait_for + timeout_ms when you know a completion pattern.

How to set it up

1. Start the bridge

The bridge is a local HTTPS server. Run it from a terminal:

bash
npx pi-for-excel-tmux-bridge

This defaults to real tmux mode on https://localhost:3341.

Options:

  • --install-missing — auto-install tmux via Homebrew (macOS)
  • TMUX_BRIDGE_MODE=stub — safe simulated mode (no real shell execution)
  • TMUX_BRIDGE_TOKEN=your-secret — require auth token
Show full SKILL.md (164 more words)Show less
2. Configure in Pi (usually not needed)

The default bridge URL (https://localhost:3341) works automatically — no configuration required. If you need a custom URL or auth token:

/experimental tmux-bridge-url <url>
/experimental tmux-bridge-token <token>
/experimental tmux-status
3. Accept the local HTTPS certificate

The bridge uses a self-signed cert. You may need to visit https://localhost:3341 in your browser once and accept it.

When the bridge is not running

The tmux tool stays registered but returns an error if the bridge is unreachable. Python tools (python_run, python_transform_range) still work via the in-browser Pyodide fallback — tmux is the only tool that strictly requires its bridge.

Security

  • Loopback-only (localhost)
  • Origin allowlist
  • Optional bearer token auth
  • Session names and key tokens are validated
  • No shell interpolation (argv-based tmux calls)

Troubleshooting

  • "bridge URL is unavailable" — the bridge process isn't running. Start it with npx pi-for-excel-tmux-bridge.
  • "timed out" — the bridge is running but the command took too long. Default timeout is 15s; use timeout_ms for longer operations.
  • CORS/cert errors — visit the bridge URL directly in your browser and accept the certificate.

© tmustier, 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/tmux-bridge of tmustier/pi-for-excel.

Open the folder on GitHubat commit a3cea8f

Compare with similar skills

Tmux Bridge 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 Bridge compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tmux Bridge this skilltmustier/pi-for-excel434—~819Automated safety check: PassMIT
XLSXrvdbreemen/OTGW-firmware20735 repos~2.9kAutomated safety check: PassProprietary
PipesHub Excel Spreadsheet Builderpipeshub-ai/pipeshub-ai3.8k—~1.8kAutomated safety check: PassApache-2.0
MineruNebutra/MinerU-Skill122—~1.4kAutomated safety check: PassMIT
Markdown Exporterbowenliang123/markdown-exporter2711 repos~5.3kAutomated safety check: PassApache-2.0
Excel Workbookadongwanai/learn-workbuddy407—~597Automated safety check: NotesMIT

Similar skills

  • XLSX

    rvdbreemen/OTGW-firmware

    Use this skill any time a spreadsheet file is the primary input or output.

    207 GitHub starsUsed in 35 repos~2.9k tokens
    Documents & OfficeAuto-check passed
  • PipesHub Excel Spreadsheet Builder

    pipeshub-ai/pipeshub-ai

    Creates and edits .xlsx workbooks with real Excel formulas rather than hardcoded computed values, defaulting to exceljs in TypeScript with a static formula-safety check.

    3.8k GitHub stars~1.8k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Mineru

    Nebutra/MinerU-Skill

    An AI-Native skill for parsing PDF / Office / image files into clean Markdown with MinerU — a fast, zero-config document parser for AI agents.

    122 GitHub stars~1.4k tokensUpdated 15 days ago
    Documents & OfficeAuto-check passed
  • Markdown Exporter

    bowenliang123/markdown-exporter

    Convert Markdown text to DOCX, PPTX, XLSX, PDF, PNG, SVG, HTML, IPYNB, MD, CSV, JSON, JSONL, XML files, and extract code blocks in Markdown to Python, Bash,JS and etc files.

    271 GitHub starsUsed in 1 repo~5.3k tokens
    Documents & OfficeAuto-check passed
  • Excel Workbook

    adongwanai/learn-workbuddy

    使用此 Skill 创建、检查、编辑和验证 XLSX 工作簿。用户提到 Excel、xlsx、工作簿、工作表、表格,或要求修改、汇总、检查 Excel 文件时使用。只支持基础 XLSX 操作,不处理宏、VBA、图表、数据透视表或外部工作簿引用。

    407 GitHub stars~597 tokensUpdated 3 days ago
    Documents & OfficeAuto-check: notes
  • Excel Workbook Editor

    TokenRhythm/opensquilla

    Inspects, edits in place or creates Microsoft Excel .xlsx workbooks with openpyxl, treating each cell as a typed number, string, datetime or formula value.

    7.1k GitHub stars~1.6k tokensUpdated 4 days ago
    Documents & OfficeAuto-check passed

More from tmustier/pi-for-excel

  • Excel Background Verification

    tmustier/pi-for-excel

    Run model-driven end-to-end tests in real local Excel while keeping it in the background.

    434 GitHub stars~2.8k tokensUpdated yesterday
    Auto-check passed
  • Wps Windows Smoke

    tmustier/pi-for-excel

    Provision or reuse a local Windows 11 ARM VM as a reusable test harness for validating pi-for-excel inside real China-domestic WPS Spreadsheets.

    434 GitHub stars~4.7k tokensUpdated yesterday
    Auto-check passed
  • Python Bridge

    tmustier/pi-for-excel

    Native Python execution via the local Python bridge. An agent skill from tmustier/pi-for-excel.

    434 GitHub stars~820 tokensUpdated yesterday
    Auto-check passed
  • Extending Pi

    tmustier/pi-for-excel

    Plan and build Pi for Excel extensions safely: choose skill vs extension plugin vs connection, create flat SKILL.md skills, and handle API keys without asking users to paste secrets in chat.

    434 GitHub stars~1.6k tokensUpdated yesterday
    Auto-check passed
  • Web Search

    tmustier/pi-for-excel

    Search the public web for up-to-date facts. An agent skill from tmustier/pi-for-excel.

    434 GitHub stars~410 tokensUpdated yesterday
    Auto-check passed
  • MCP Gateway

    tmustier/pi-for-excel

    Discover and call tools from configured MCP servers. An agent skill from tmustier/pi-for-excel.

    434 GitHub stars~241 tokensUpdated yesterday
    Auto-check passed

Works with

Questions about Tmux Bridge

What does Tmux Bridge do?

Local terminal access via the tmux bridge. An agent skill from tmustier/pi-for-excel. Tmux Bridge is an agent skill from tmustier/pi-for-excel. Local terminal access via the tmux bridge.

When should I use Tmux Bridge?

Tmux Bridge fits situations like: the user asks about running shell commands; setting up the tmux bridge; troubleshooting terminal connectivity.

How do I install Tmux Bridge in Claude Code?

Run `npx skills add tmustier/pi-for-excel --skill tmux-bridge -a claude-code`. Or copy the skill folder (skills/tmux-bridge in tmustier/pi-for-excel) into .claude/skills/tmux-bridge in your project. Claude Code loads it when a task matches its description.

How do I install Tmux Bridge in Codex?

Run `npx skills add tmustier/pi-for-excel --skill tmux-bridge -a codex`. Or copy the skill folder (skills/tmux-bridge in tmustier/pi-for-excel) into .agents/skills/tmux-bridge in your project. Codex loads it when a task matches its description.

Can I use Tmux Bridge 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 tmustier/pi-for-excel --skill tmux-bridge -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-bridge, .gemini/skills/tmux-bridge, .github/skills/tmux-bridge and .opencode/skills/tmux-bridge in your project.

What does Tmux Bridge need to run?

Going by SKILL.md and its folder, Tmux Bridge needs the command-line tools its instructions call (npx) and credentials named TMUX_BRIDGE_TOKEN. Our summary lists: Python 3; Node.js; A credential in TMUX_BRIDGE_TOKEN. Compatibility (from SKILL.md): Requires a local tmux bridge process running on the user's machine..

Does Tmux Bridge access the network?

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

Is Tmux Bridge 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 Bridge use?

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

How many tokens does Tmux Bridge use?

About 819 tokens (SKILL.md is roughly 3.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 Tmux Bridge?

Skills that share tags, products or a category with Tmux Bridge: XLSX (rvdbreemen/OTGW-firmware, 207 stars), PipesHub Excel Spreadsheet Builder (pipeshub-ai/pipeshub-ai, 3.8k stars), Mineru (Nebutra/MinerU-Skill, 122 stars) and Markdown Exporter (bowenliang123/markdown-exporter, 271 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tmux Bridge?

tmustier (a GitHub user) maintains it in tmustier/pi-for-excel, which has 434 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 8, 2026.

Source: tmustier/pi-for-excel on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.