Agent Plugins Marketplace
← All plugins

tmux-agent-tools

v0.40.1

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 Skills

By PaulYeh0 GitHub starsUpdated 6 days ago

Directory evidence

Runtimes
Codex and Claude Code
Parsed components
2 skill or MCP entries
Source updated
Sep 18, 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-tools 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-tools@agent-plugin-marketplace

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

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-tools/
├── .codex-plugin/plugin.json
├── .claude-plugin/plugin.json
├── skills/tmux-agent-tools/SKILL.md
└── skills/using-tmux-agent-tools/SKILL.md

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.

Plugin manifests2

.codex-plugin/plugin.json
{
  "name": "tmux-agent-tools",
  "version": "0.40.1",
  "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/",
  "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 with no MCP server or hooks.",
    "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-tools",
  "version": "0.40.1",
  "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/"
}

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-tools on Agent Plugins Marketplace](https://pluginsmp.com/plugins/tmux-agent-tools)