termmux

Name: termmux
Author: CloudCorpRecords

本地服务

github.com/CloudCorpRecords开发工具02 周前更新

代码仓库

关于 termmux

termmux 是用于操作本地 tmux 会话、窗口和面板的命令行工具与 stdio MCP 服务。它提供 tmux 管理及面板输入输出操作，并通过参数数组调用程序，而非拼接 Shell 命令。

主要功能

01列出和管理会话
02创建、重命名及关闭窗口
03列出和管理面板
04向面板发送按键
05捕获面板可见输出
06作为命令行工具或 stdio MCP 服务运行

适用场景

01查看当前 tmux 会话
02创建或删除会话与窗口
03向面板发送命令
04读取面板当前可见文本

MCP 相关

termmux 通过 stdio 作为 MCP 服务运行，向客户端提供列出和管理 tmux 会话、窗口及面板，以及发送按键和捕获输出的工具。主机需要安装 tmux 二进制文件。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "cloudcorprecords-termmux": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/termmux"
      ]
    }
  }
}

启动命令npx -y @reneturcios/termmux

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@reneturcios/termmux0.1.0stdio

ocighcr.io/cloudcorprecords/termmux:0.1.0stdio

工具

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

termmux

通过命令行或作为 stdio MCP 服务来操作本地 tmux。列出、创建、重命名和关闭会话；管理窗口和窗格；向窗格发送按键并捕获其可见输出。

每项操作都会通过可注入的执行器，使用参数数组运行真正的 tmux 二进制文件（execFile，绝不使用 shell 字符串），因此会话名称和按键文本不会被重新解释为 shell 语法。指定一个不存在的会话名称时，会返回 tmux 自己的错误。当没有 tmux 服务运行时，列表调用会返回空列表—— 这与 tmux 报告的空世界相同。

安装

npx -y @reneturcios/termmux mcp

主机上需要有 tmux 二进制文件（容器映像未附带该文件，因此在容器中运行时会报告 tmux 不可用）。

CLI

termmux mcp
termmux list-sessions
termmux create-session <name> [window] [start-dir]
termmux kill-session <name>
termmux list-windows <session>
termmux capture <session> [pane]
termmux send <session> <keys...>
termmux --version

退出代码：0 表示成功，1 表示 tmux 错误，2 表示用法错误。

MCP 工具

工具	用途
`list_sessions`	列出所有 tmux 会话
`create_session`	创建新的 tmux 会话
`kill_session`	按名称关闭 tmux 会话
`list_windows`	列出 tmux 会话中的窗口
`create_window`	在 tmux 会话中创建新窗口
`kill_window`	关闭 tmux 会话中的窗口
`list_panes`	列出 tmux 会话中的窗格，可选择指定一个窗口
`send_keys`	向 tmux 窗格发送按键（命令行或按键名称）
`capture_pane`	将 tmux 窗格的可见内容捕获为文本
`rename_session`	重命名 tmux 会话
`select_window`	选择（激活）tmux 会话中的窗口
`get_session_info`	获取一个 tmux 会话的详细信息

MCP 客户端配置：

{
  "mcpServers": {
    "termmux": {
      "command": "npx",
      "args": ["-y", "@reneturcios/termmux", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/termmux          # MCP server (tmux unavailable in-image)
docker run --rm ghcr.io/cloudcorprecords/termmux --version