skills.rest
devseunggwan
devseunggwanCOMMUNITY
Explore all skills by this author →
GitHub

cmux-save-sessions

Save cmux workspace session layouts to deterministic JSON snapshots.

Updated Jan 6, 2026
Search Tags:#automation#workspace#tmux#session-management#cmux#json-snapshot
One-click install
npx skills add https://github.com/devseunggwan/praxis --skill cmux-save-sessions
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cmux-save-sessions
Source: https://github.com/devseunggwan/praxis/tree/main/skills/cmux-save-sessions
Command: npx skills add https://github.com/devseunggwan/praxis --skill cmux-save-sessions

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, tmux, cmux-session-manager.

What problem does it solve?

Managing and recovering multi-workspace layouts across restarts or sharing setups can be error-prone. This skill saves the current state of cmux workspaces as a deterministic JSON snapshot, excluding the manager session by default, to enable reliable recovery, auditing, and sharing.

Core Features & Use Cases

  • Capture the current cmux workspace layout, including per-workspace ref, name, state, branch, PR status, category, and cwd, for auditing, sharing, or restoration.
  • Persist snapshots to the standard location ~/.cmux/sessions/ with a timestamped filename, enabling incremental history; supports including the manager session via a flag.
  • Integrates with related skills for restoration and crash recovery (cmux-resume-sessions, cmux-recover-sessions) and with the session manager for persistent records.

Quick Start

Run the cmux-save-sessions script to generate a JSON snapshot of your current cmux workspaces.

Frequently Asked Questions about cmux-save-sessions

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

FAQPage Schema
How do I save my tmux workspace session layout as a JSON snapshot?▼

To save a tmux workspace layout, run the save script to generate a JSON snapshot capturing per-workspace refs, names, states, branches, categories, and cwd. It persists to a timestamped file in the standard sessions directory.

What is the best way to snapshot cmux sessions for recovery or auditing?▼

The best way to snapshot cmux sessions for auditing or recovery is to generate a deterministic JSON object containing saved_at, hostname, total, summary, and session states. By default, it excludes the manager session from the output.

Do I need jq and tmux installed to save cmux workspace sessions?▼

Yes, you need jq, tmux, and cmux-session-manager installed. These dependencies are required to parse workspace data and capture the current session layout for the JSON snapshot output.

Can I include the manager session when saving a cmux session layout?▼

Yes, you can include the manager session when saving a cmux session layout by applying a specific flag. By default, the save logic excludes the manager session to focus strictly on active workspace data.

Where are cmux session JSON snapshots stored for incremental history?▼

cmux session JSON snapshots are stored in the standard location at ~/.cmux/sessions/ with a timestamped filename. This enables incremental history tracking for reliable recovery and sharing workflows.

Related Skills

Explore More Software Engineering Skills→
angusjfwangusjfw
5

claude-manager-shutdown

Capture tmux session snapshots and update registry entries for Claude shutdown.

Community
Intermediate
devseunggwandevseunggwan

cmux-resume-sessions

Restore cmux workspaces from a saved JSON snapshot and resume Claude Code sessions.

Community
Advanced
Yeachan-HeoYeachan-Heo
32.6k

psm

Manage isolated development sessions using git worktrees and tmux.

Community
Basic
greenheadHQgreenheadHQ
4

managing-tmux

Configure tmux with plugins and Pane Notepad for multi-pane workflows.

Community
Intermediate