tmux-ai-chat

Manage tmux panes and capture AI responses between markers.

Updated Feb 4, 2026
One-click install
npx skills add https://github.com/sizukutamago/dev-tools-plugin --skill tmux-ai-chat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tmux-ai-chat
Source: https://github.com/sizukutamago/dev-tools-plugin/tree/main/skills/tmux-ai-chat
Command: npx skills add https://github.com/sizukutamago/dev-tools-plugin --skill tmux-ai-chat

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill provides a reusable, marker-based foundation for AI chat collaboration inside tmux, enabling consistent pane management, message sending, and output capture across multiple AI agents.

Core Features & Use Cases

  • Unified collaboration layer: Centralizes split, send, capture, and kill operations for AI chat workflows.
  • Marker-based output extraction: Facilitates deterministic capture of AI responses between start/end markers.
  • Use Case: Build higher-level AI collaboration skills (e.g., Codex/Cursor/ Gemini integrations) that chat through tmux panes.

Quick Start

Create a pane and launch an AI CLI, send a prompt, and capture the response between markers using the tmux_ai.sh script.

  • pane=$(tmux_ai.sh split --direction h --percent 50 --name ai --print-pane-id)
  • id=$(tmux_ai.sh send --pane "$pane" --wrap --text "Explain Tradeoffs" --enter)
  • tmux_ai.sh capture --pane "$pane" --between "$id" --wait-ms 30000

Frequently Asked Questions about tmux-ai-chat

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate AI chat interactions and capture output in tmux panes?

You can automate AI chat in tmux by using a marker-based script to split panes, send prompts, and capture deterministic output between start and end markers. This provides a unified bash foundation for orchestrating pane management operations.

What is marker-based output extraction for tmux pane management?

Marker-based output extraction captures AI responses deterministically by tracking specific start and end markers generated when a prompt is sent. This ensures reliable retrieval of chat outputs from the tmux pane for automated workflows.

How to send a prompt to an AI CLI and capture the response in a tmux split?

To send a prompt and capture the response, use the tmux_ai.sh script to split a pane, send text with an enter command, and then capture the output between the returned marker ID with a specified wait time.

Do I need a specific tmux version to run marker-based AI chat scripts?

Yes, running marker-based AI chat scripts requires tmux version 3.0 or higher, along with bash. These dependencies are necessary to support the automated pane management and message orchestration features.

Can I use this tmux automation skill to build integrations for multiple AI agents?

Yes, this skill serves as a reusable core layer for building higher-level AI collaboration skills. It centralizes split, send, capture, and kill operations, enabling consistent message orchestration across multiple AI agents like Codex or Gemini.

What is the best way to manage multiple AI chat sessions in tmux?

The best way to manage multiple AI chat sessions is using a unified, marker-based foundation that centralizes pane creation, message sending, and output capture. This ensures deterministic and reliable orchestration across various AI agents.