Menu
Delete a TwiCC workspace by id. Projects are NOT deleted — only the grouping disappears. Use when you or the user want to drop a workspace.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Create a new TwiCC session with a prompt and optional agent settings (provider, model, effort, permission mode, etc.). Use when you or the user want to spawn a fresh Claude Code/Codex session, kick off a sub-task in another project, or scaffold from a script.
Update an existing TwiCC session — change settings, title, annotations, archive/unarchive, pin/unpin, hide/unhide. Use when you or the user want to change a session without sending a message.
Read-only inspection of TwiCC — version, providers (and enabled state), slash/dollar commands, supported models, agent-settings choices/constraints, and presets — any subset composed into one JSON. Use when you or the user need a machine-readable picture of what's available before scripting a session, picking a preset/model, or filtering commands.
Update an existing TwiCC project — rename, change color, archive/unarchive, set its default provider, worktree directory or saved browser URLs, or edit per-provider agent-settings defaults. The directory is immutable; projects are archived, never deleted.
Apply the same update to several TwiCC sessions — archive/unarchive, pin/unpin, hide/unhide, annotations, or settings. Use when you or the user want to change many sessions in one call (e.g. hide a whole batch, tag every worker in an orchestration, or bump model/effort of all your children).
Create a new TwiCC workspace — a group of projects, optionally with a color, auto-add directory patterns, an initial project list, and a browser URL. Use when you or the user want to create a workspace.
| name | twicc-delete-workspace |
| description | Delete a TwiCC workspace by id. Projects are NOT deleted — only the grouping disappears. Use when you or the user want to drop a workspace. |
| argument-hint | <workspace_id> |
Delete a workspace. Projects are not affected — they remain in TwiCC and in any other workspace that lists them. Only the grouping disappears. The operation is immediate and has no undo (the workspace can be recreated with $TWICC create-workspace).
Prefer the mcp__twicc__* tools when you have them. Inside a TwiCC session your tool list may include mcp__twicc__* tools — one per command below (the command with / and - turned into _, e.g. mcp__twicc__create_session, mcp__twicc__update_session_settings). When present, use them instead of the $TWICC CLI: same arguments, same JSON result, no shell, and your session identity travels with the call so self/parent resolve on their own. Fall back to the $TWICC CLI below when those tools aren't available (outside a session, or when scripting from a terminal).
TwiCC's executable varies by launch mode (uvx, dev, installed tool). ALWAYS USE THIS TO RESOLVE $TWICC AT THE START OF EACH BASH INVOCATION:
TWICC=${TWICC_BIN:-$(command -v twicc 2>/dev/null)}
[ -n "$TWICC" ] || { echo "TwiCC executable not found in this context" >&2; exit 1; }
Then run $TWICC <args> — never quote $TWICC (use $TWICC args, never "$TWICC" args): it may expand to multiple words, which quoting would break.
$TWICC delete-workspace '<WORKSPACE_ID>'
WORKSPACE_ID — id of the workspace (the slug — does NOT match the display name verbatim).--timeout SECONDS — Seconds to wait for the server's response (default 30).workspace_not_foundworkspace_not_found — race: workspace deleted between local check and server write.{"status":"deleted","workspace_id":"backend","request_uuid":"..."}
{"status":"validation_error","errors":[{"field":"WORKSPACE_ID","code":"workspace_not_found","message":"..."}]}
{"status":"rejected","errors":[{"field":"...","code":"...","message":"..."}],"request_uuid":"..."}
{"status":"failed","error":"...","request_uuid":"..."}
{"status":"timeout","received_seen":true,"message":"...","request_uuid":"..."}
0 — Workspace deleted1 — Local validation error2 — TwiCC server not running3 — Server rejected4 — Server error5 — Timeout64 — Bad CLI usage$TWICC delete-workspace scratch
# → {"status":"deleted","workspace_id":"scratch","request_uuid":"..."}
$TWICC workspace <ID> / $TWICC workspaces — inspect or list. Skill: twicc-workspace / twicc-workspaces.$TWICC create-workspace <NAME> — recreate a workspace. Skill: twicc-create-workspace.$TWICC update-workspace <ID> --archive — archive instead of deleting (reversible). Skill: twicc-update-workspace.workspace_not_found, the user likely used the display name instead of the slug — suggest $TWICC workspaces to find the right id.