菜单
Show details of a single TwiCC workspace by ID. Use when you or the user want to inspect a workspace's projects, color, archived state, or auto-add patterns.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
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-workspace |
| description | Show details of a single TwiCC workspace by ID. Use when you or the user want to inspect a workspace's projects, color, archived state, or auto-add patterns. |
| argument-hint | <workspace_id> |
Show the full details of a single workspace by its ID, including when archived.
$TWICC workspaces or from a project's workspaces field) and want to see its content.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 workspace <WORKSPACE_ID>
The WORKSPACE_ID is the slug shown by $TWICC workspaces. The ID does NOT change when the workspace is renamed, so it may look unrelated to the current name.
{
"id": "backend",
"name": "Backend",
"archived": false,
"color": "#4a90d9",
"projectIds": [
"-home-twidi-dev-api",
"-home-twidi-dev-workers"
],
"autoProjectPatterns": [
"/home/twidi/dev/api*"
]
}
id — slug derived from the name at creation time; never changes on rename.name — display name (mutable).color — may be null.projectIds — project IDs (leading dash included). Drop the leading dash when passing on the command line; prefer directory paths when possible.autoProjectPatterns — auto-add patterns (* wildcard). A pattern without * is treated as a directory prefix.$TWICC workspaces — list all workspaces. Skill: twicc-workspaces.$TWICC update-workspace <ID> — rename, recolor, add/remove projects or patterns, archive/unarchive. Skill: twicc-update-workspace.$TWICC delete-workspace <ID> — delete a workspace. Skill: twicc-delete-workspace.$TWICC create-workspace <NAME> — create a new workspace. Skill: twicc-create-workspace.$TWICC project <PROJECT> — inspect a project from projectIds. Skill: twicc-project.$TWICC sessions --project <PROJECT> — list sessions for a project. Skill: twicc-sessions.$TWICC sessions --workspace <ID> — list sessions for a workspace.projectIds).autoProjectPatterns is set, mention that the workspace auto-grows for matching directories.[link text](/projects?workspace={workspace_id}).