project-reload

Deploy or restore cmux workspace agents from local database state.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/merong/cmux-workshop --skill project-reload
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-reload
Source: https://github.com/merong/cmux-workshop/tree/main/plugins/cmux-workshop/skills/project-reload
Command: npx skills add https://github.com/merong/cmux-workshop --skill project-reload

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, sqlite3, cmux, and includes scripts (resource) components.

What problem does it solve?

Deploys or restores cmux workspace agents across the phase-3 deployment, coordinating pane creation, agent bootstrapping, and session restoration to keep the workspace in sync.

Core Features & Use Cases

  • Orchestrates initial deployment and subsequent reloads of cmux agents based on the project's local database state.
  • Auto-migrates legacy schemas, restores missing cmux panes, resumes Claude/Codex sessions when available, and upserts local workspace structures.
  • Maintains a consistent local_workspace and local_surfaces map and marks progress.deployed when deployment completes.
  • Use Case: Upgrade from phase-2 to phase-3 by running project:reload to redeploy agents without interrupting active work.

Quick Start

Trigger this skill with the project-reload command to deploy or restore your cmux workspace.

Frequently Asked Questions about project-reload

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

FAQPage Schema
How do I restore cmux workspace agents after an unexpected session interruption?

To restore cmux workspace agents, this skill orchestrates pane recreation and session resumption using stored CLI state. It automatically resumes Claude or Codex sessions and upserts local workspace structures based on your project database.

What do I need to set up before deploying cmux agents?

Before deploying cmux agents, you need python3, sqlite3, and cmux installed. A functioning .claude/project.db must exist, the agents phase must be completed, and Claude or Codex session CLI state must be available for resumption.

Can I reload cmux panes without losing my active workspace state?

Yes, you can reload cmux panes without losing active workspace state. The skill upserts local workspace maps, auto-migrates legacy schemas, and resumes sessions without interrupting active work during the phase-3 upgrade.

How does cmux session resumption work with a local SQLite database?

Cmux session resumption reads stored CLI state from the local SQLite project database to restart Claude or Codex sessions. The skill recreates missing panes, applies schema migrations, and verifies readiness across the project lifecycle.

Why are my cmux workspace panes not restoring correctly after a schema migration?

Cmux workspace panes fail to restore if the agents phase is incomplete or the .claude/project.db schema is outdated. This skill auto-migrates legacy schemas, verifies readiness, and upserts workspace structures to ensure proper pane synchronization.

What is the best way to upgrade cmux agents from phase-2 to phase-3?

The best way to upgrade cmux agents from phase-2 to phase-3 is triggering project:reload. It handles schema migrations, pane creation, and session resumption automatically, keeping your workspace synchronized without interrupting active work.