← ClaudeAtlas

session-workspacelisted

Understand the session-workspace plugin's config-driven tmux lifecycle commands (doctor/plan/start/status/stop/restart/reconcile/install). Use before invoking any session-workspace skill so you pick the right one and know the safety gates.
devgirishattri/agent-plugins · ★ 0 · Web & Frontend · score 72
Install: claude install-skill devgirishattri/agent-plugins
# Session Workspace `session-workspace` is a shared engine that replaces hand-maintained per-project `workspace.sh` launchers. Instead of several near-identical scripts drifting independently, one engine reads a versioned, project-local `.agent-workspace/workspace.json` config and drives tmux session/window/pane lifecycle from it. The engine is implemented. It validates config, renders mutation-free plans, starts/stops/reconciles managed tmux sessions and panes, builds Claude/Codex argv, pins non-secret coordination env, and runs read-only diagnostics. ## Choosing A Skill | Use case | Skill | Notes | | --- | --- | --- | | Health/dependency check | `$session-workspace:workspace-doctor` | Read-only | | Preview what start would do | `$session-workspace:workspace-plan` | Mutates nothing | | Bring the workspace up | `$session-workspace:workspace-start` | Sessions/panes/agents/services | | Check current state | `$session-workspace:workspace-status` | Read-only | | Tear the workspace down | `$session-workspace:workspace-stop` | Destructive, needs `--confirmed` | | Stop then start | `$session-workspace:workspace-restart` | Destructive; stop confirmation is passed internally | | Repair drifted tmux state | `$session-workspace:workspace-reconcile` | Only sanctioned adoption path | | Install the `workspace` command | `$session-workspace:workspace-install` | Puts the dispatcher on PATH; no config, no tmux, idempotent | ## Configuration Model A project opts in by creating `.agent-wo