Agent Plugins Marketplace
← All plugins

tmux-agent

v0.42.0

Tmux wrappers and a skill for running Claude Code or Codex CLI as controllable, supervised named sessions: an inline-vs-worker delegation gate, start/resume, send, wait, capture, status/doctor/setup, result files, human approval gates, and multi-agent pair/team orchestration.

CodexClaude Code2 Skills1 MCP serverstdio

By PaulYehLicense: MIT0 GitHub starsUpdated 1 hour ago

Directory evidence

Runtimes
Codex and Claude Code
Parsed components
3 skill or MCP entries
Source updated
Oct 2, 2026
Manifest status
Canonical path parsed

The directory validates manifest shape and source location. It does not execute the plugin or provide a security endorsement. Review the indexing methodology →

Install tmux-agent for Codex and Claude Code

Installs for the current user
codex plugin marketplace add IchenDEV/agent-plugin-mkt
codex plugin marketplace upgrade agent-plugin-marketplace
codex plugin add tmux-agent@agent-plugin-marketplace

Paste and run these commands in a terminal with Codex. They add and refresh the PluginsMP catalog, then install this plugin.

Compatibility: the page URL and API slug “tmux-agent-3” remain stable.

  • Codex: tmux-agent-3@agent-plugin-marketplace → tmux-agent@agent-plugin-marketplace

The installer fetches third-party code from the source repository shown on this page. This directory validates manifest structure and source location, but does not perform a security audit; review the manifest, components, and source before installing.

Get the source manually
git clone https://github.com/ohyeh/tmux-agent-tools

Clone the source repository, then follow its setup instructions to add the plugin to a compatible client. The repository root is the plugin root.

Plugin files

tmux-agent/
├── .codex-plugin/plugin.json
├── .claude-plugin/plugin.json
├── skills/tmux-agent-tools/SKILL.md
├── skills/using-tmux-agent-tools/SKILL.md
└── .mcp.json

Included Skills2

tmux-agent-toolsskills/tmux-agent-tools/SKILL.md

Mechanics library for running AI coding CLIs as managed tmux workers via agent-tmux <cli> <command> (plus tmux-agent-sessions and the other bundled tools). Entry point is the using-tmux-agent-tools router skill — route through it first; read this skill for wrapper mechanics it defers to. Covers start/send-wait/status/result/stop, structured result.json completion, multi-worker watch, profiles for custom CLIs, and bounded dialogue/fanout. Not for general tmux config, theming, non-tmux headless CLI use, or human team debate.

using-tmux-agent-toolsskills/using-tmux-agent-tools/SKILL.md

Meta-router for the tmux-agent-tools plugin. Invoke BEFORE choosing a wrapper or delegating any tmux-agent work — it decides inline vs worker, picks the right script, and points at the canonical capability table. Even a 1% chance this applies means invoke it.

MCP servers1

tmux-agentstdio
command
./skills/tmux-agent-tools/scripts/tmux-agent-mcp
cwd
.

Plugin manifests2

.codex-plugin/plugin.json
{
  "name": "tmux-agent",
  "version": "0.42.0",
  "description": "Tmux wrappers and a skill for running Claude Code or Codex CLI as controllable, supervised named sessions: an inline-vs-worker delegation gate, start/resume, send, wait, capture, status/doctor/setup, result files, human approval gates, and multi-agent pair/team orchestration.",
  "author": {
    "name": "PaulYeh",
    "url": "https://github.com/ohyeh"
  },
  "homepage": "https://github.com/ohyeh/tmux-agent-tools#readme",
  "repository": "https://github.com/ohyeh/tmux-agent-tools",
  "keywords": [
    "tmux",
    "claude-code",
    "codex",
    "agent",
    "orchestration",
    "multi-agent",
    "session",
    "supervision"
  ],
  "skills": "./skills/",
  "mcpServers": "./.codex-plugin/mcp.json",
  "interface": {
    "displayName": "tmux-agent-tools",
    "shortDescription": "Supervise Claude Code / Codex CLI as controllable tmux sessions",
    "longDescription": "tmux-agent-tools turns Claude Code and Codex CLI into controllable, supervised tmux sessions. It provides start/resume, send, wait, capture, status/doctor, structured result files, human approval gates, and multi-agent pair/team orchestration through shell wrappers, exposed here as a skill plus the tmux-agent-mcp worker-lifecycle MCP server.",
    "developerName": "PaulYeh",
    "category": "Productivity",
    "capabilities": [
      "Run Claude Code or Codex CLI as named, supervised tmux sessions",
      "Decide inline vs worker execution with the skill's inline-vs-worker gate",
      "Send prompts, wait for markers, and capture pane output without attaching",
      "Read structured result.json files instead of scraping panes",
      "Gate destructive actions behind human approval files",
      "Orchestrate multi-agent pair and team review workflows"
    ],
    "defaultPrompt": [
      "Start a supervised agent session for this task with agent-tmux claude start or agent-tmux codex start, then report its structured result."
    ]
  }
}
.claude-plugin/plugin.json
{
  "name": "tmux-agent",
  "version": "0.42.0",
  "description": "tmux wrappers, a skill and a Claude Code function-hook mod for running Claude Code, Codex, Cursor, agy or grok CLI workers as supervised tmux teammates: dispatch from an MCP tool, the /workers panel, and a collector that wakes the session when a worker finishes or fails to launch. The skills also install via npx skills for other CLIs.",
  "author": {
    "name": "PaulYeh",
    "url": "https://github.com/ohyeh"
  },
  "homepage": "https://github.com/ohyeh/tmux-agent-tools#readme",
  "repository": "https://github.com/ohyeh/tmux-agent-tools",
  "keywords": [
    "tmux",
    "claude-code",
    "codex",
    "agent",
    "orchestration",
    "multi-agent",
    "session",
    "supervision"
  ],
  "skills": "./skills/",
  "displayName": "tmux Agent Tools",
  "license": "MIT",
  "types": "./types/index.d.ts"
}

For maintainers

If you maintain this plugin, link to this source-backed listing from your README so users can review its manifest and indexed components.

[tmux-agent on Agent Plugins Marketplace](https://pluginsmp.com/plugins/tmux-agent-3)