session-workspacelisted
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