terminal-detach-tmux-session

Detach MCP from an active tmux session while preserving background processes.

19|14|Updated Feb 4, 2026
One-click install
npx skills add https://github.com/X-School-Academy/skill-pilot --skill terminal-detach-tmux-session
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: terminal-detach-tmux-session
Source: https://github.com/X-School-Academy/skill-pilot/tree/main/core/skills/system/terminal-detach-tmux-session
Command: npx skills add https://github.com/X-School-Academy/skill-pilot --skill terminal-detach-tmux-session

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill allows you to detach from a tmux session without terminating the processes running within it, ensuring background tasks continue uninterrupted.

Core Features & Use Cases

  • Background Task Management: Keep your long-running processes active even after you disconnect.
  • Session Independence: Freely move between monitoring sessions or disconnect entirely while work continues.
  • Use Case: You've started a lengthy data processing job in a tmux session. You need to leave your computer but want the job to finish. Detach from the session to free up your terminal while the job runs in the background.

Quick Start

Detach from the tmux session with the ID sess-abc123.

Frequently Asked Questions about terminal-detach-tmux-session

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

FAQPage Schema
How do I detach from a tmux session without stopping background processes?

To detach from a tmux session without stopping background processes, the Skill disconnects the MCP from the active session, allowing the underlying workload to continue running uninterrupted after agent disconnection.

What happens to my long-running workload when I disconnect from a tmux session?

When you disconnect from a tmux session, your long-running workload continues to execute in the background. The Skill frees your terminal while ensuring the underlying processes remain active and uninterrupted.

Can I detach from a tmux session using a specific session ID?

Yes, you can detach using a specific session ID. The Skill validates that the provided session ID corresponds to an active tmux session before initiating the detach operation to ensure a successful disconnection.

When do I need to detach from a tmux session for background task management?

You need to detach from a tmux session for background task management when you have long-running processes initiated with lifecycle tmux and require continued execution after leaving your terminal or disconnecting your agent.

Does detaching from a tmux session terminate the processes inside?

Detaching from a tmux session does not terminate the processes inside. The Skill specifically disconnects the MCP from the tmux-backed session, ensuring the underlying workload continues running without interruption.