gitwtfhub

wtf is tmux.skill?

popbones/tmux.skill — explained in plain English

Analysis updated 2026-05-18

14ShellAudience · developerComplexity · 2/5Setup · easy

TL;DR

A tiny Codex agent skill that teaches the model to run long-lived commands inside tmux panes, with a helper script for sending input and capturing output.

Mindmap

mindmap
  root((tmux.skill))
    Inputs
      tmux target
      Send text
      Capture lines
    Outputs
      Pane output
      Queued input
    Use Cases
      Long-running dev servers
      File watchers in agents
      Log tailing
    Tech Stack
      Shell
      tmux
      Codex
    Files
      SKILL.md
      tmux-send-and-capture
      openai.yaml

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Let a Codex agent start a dev server in a tmux pane and return to it later

REASON 2

Send text into a tmux pane and capture the last N lines of output

REASON 3

Queue input to a pane where Codex is already running so it reads it after the current task

What's in the stack?

Shelltmux

How it stacks up

popbones/tmux.skillalhajashafffy/shellsafebrettkinny/tower-dashboard
Stars141414
LanguageShellShellShell
Setup difficultyeasyeasymoderate
Complexity2/52/52/5
Audiencedeveloperops devopsops devops

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Requires tmux already installed and a working Codex setup with the skills directory in place.

Wtf does this do

This repository, tmux.skill by popbones, packages a small skill for OpenAI's Codex coding agent that teaches it how to use tmux as a place to run long-running commands. tmux is a Unix tool that keeps terminal sessions alive in named windows and panes, so the idea here is to give an AI agent a way to start a dev server, a file watcher, a build, a log tail, or any interactive command, and then come back to it later instead of running everything in one short-lived shell. The repo is intentionally tiny. It contains three pieces: SKILL.md, which holds the instructions Codex itself reads to learn the workflow, a shell helper at scripts/tmux-send-and-capture, which sends text into a chosen tmux pane and reads back the most recent lines of output, and agents/openai.yaml, which carries the metadata Codex uses to show the skill in its interface. To install it, the README says to clone or copy the folder into the Codex skills directory, which lives at $CODEX_HOME/skills/tmux, or under ~/.codex/skills/tmux if that variable is not set. After a fresh Codex session, the new skill is picked up. The helper script takes a tmux target in the usual session:window.pane format, an optional number of lines to capture, and the text to send. One example sends the string status please to a coordination pane and grabs the last 80 lines. A second example uses a --codex-queue flag to push text into a pane where Codex is already busy, so the message waits until the current task finishes before being read. The README does not describe a license, tests, or any wider configuration. It is meant as a building block for agent workflows that need durable shells, and it expects the user to already have tmux installed and a working Codex setup.

Yoink these prompts

Prompt 1
Install tmux.skill into ~/.codex/skills/tmux and verify Codex picks it up
Prompt 2
Use tmux-send-and-capture to start npm run dev in a pane and tail its output
Prompt 3
Show me how the --codex-queue flag changes the send-and-capture behavior
Prompt 4
Wire this skill into an agent loop that runs a build, watches output, and reacts to errors

Frequently asked questions

wtf is tmux.skill?

A tiny Codex agent skill that teaches the model to run long-lived commands inside tmux panes, with a helper script for sending input and capturing output.

What language is tmux.skill written in?

Mainly Shell. The stack also includes Shell, tmux.

How hard is tmux.skill to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is tmux.skill for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.