mcpField
T
tmux-background-tasks

tmux-background-tasks

github.com/justbecauselabs开发1108 次安装10 周前更新
代码仓库

关于 tmux-background-tasks

tmux-background-tasks 是用于通过 tmux 会话运行和管理长期命令的技能,涵盖检查 tmux、复用会话,以及连接到后台任务或停止任务。

主要功能

  1. 01检查是否已安装 tmux
  2. 02在分离会话中启动命令
  3. 03复用现有会话
  4. 04提供连接和查看日志的命令
  5. 05按需停止会话

适用场景

  1. 01保持开发服务器持续运行
  2. 02运行监视进程并执行其他命令
  3. 03重新连接后台工作进程

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/justbecauselabs/agent-skills --skill tmux-background-tasks

安装后在 Claude Code 中输入/tmux-background-tasks确认已加载。

详细介绍

Tmux 后台任务

如果未安装 tmux,请停止并要求用户安装后再继续。

概述

使用 tmux 在后台运行和管理长期运行的命令。不要使用默认进程工具让这些任务持续运行;始终在 tmux 中启动它们,这样它们就能在不同命令之间持续运行,并可重新连接。

工作流

  1. 确认已安装 tmux 如果缺少 tmux,请停止并要求用户安装(例如,在 macOS 上运行 brew install tmux)。在 tmux 可用之前不要继续。

  2. 选择稳定的会话名称 使用可预测且唯一的名称,例如 <repo>-<task>(例如,myapp-api、myapp-expo)。

  3. 启动或复用会话 启动新会话之前,先检查是否已有会话。

  4. 提供连接和分离说明 告知用户如何连接到会话,以便查看日志或进行交互。

  5. 按要求停止或重启 用户要求停止任务时,妥善终止会话。

命令模式

检查 tmux:

  • command -v tmux
  • tmux -V

创建运行命令的新分离会话:

  • tmux new-session -d -s <name> -- <command>
  • 如果需要登录 shell 或环境:tmux new-session -d -s <name> -- bash -lc '<command>'

复用或连接:

  • tmux has-session -t <name>
  • tmux attach -t <name>
  • tmux ls

发送停止信号或终止:

  • tmux send-keys -t <name> C-c
  • tmux kill-session -t <name>

查看最近的输出(非交互式):

  • tmux capture-pane -pt <name> -S -200

注意事项

  • 对于应在执行其他命令时持续运行的服务、监视程序、工作进程和开发工具,优先使用 tmux。
  • 避免创建重复会话。如果 tmux has-session -t <name> 成功,则复用该会话或连接到它。

评论

支持 Markdown