twicc

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.

Update an existing TwiCC workspace — rename, change color, add/remove projects, add/remove auto-add patterns, manage its saved browser URLs, archive/unarchive. Use when you or the user want to tweak a workspace.

Act as the leader of a TwiCC orchestration tree — decompose a user's task, spawn managers and/or workers, aggregate, and report back. Load when a user puts you in charge; read twicc-orchestration first.

Act as a manager in a TwiCC orchestration tree — take your parent's mandate, decompose it across your children, aggregate, and report up. Load when a parent makes you a manager; read twicc-orchestration first.

Shared model and conventions for multi-session orchestration in TwiCC — the leader/manager/worker tree, talking to children, visibility/permission propagation. Load this first, then the skill for your mode.

Act as a worker in a TwiCC orchestration tree — execute one concrete task and deliver the result to your parent. Load when a parent gives you a task; read twicc-orchestration first.

List bookmarked artifacts (viewable files saved from a session's Artifacts tab), or bookmark/unbookmark one. Use when you or the user want to browse bookmarks, filter them by project/workspace/scope, or add, rename, re-scope, or remove one from the CLI.

Create a new TwiCC project from a directory path — optionally with a display name and a color. One project per directory. Use when you or the user want to register a directory as a TwiCC project before any session has run in it.

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.

Inspect or control (stop or wait for state) the live process of a single TwiCC session. Use when you or the user want details on a live process, stop a running agent, or block a script until a session finishes.

List live TwiCC processes, batch-look up states by session_id, batch-stop agents, or batch-wait until sessions reach a given state. Use when you or the user want to see what's running, track spawned sessions, or gate a script on multiple sessions finishing.

Show details of a single project by directory path or ID. Use when you or the user want to inspect a project's metadata, cost, or directory.

List all projects tracked by TwiCC, or batch-look up specific ones by directory path or id. Use when you or the user want to browse projects, find a project ID, or batch-fetch metadata for known ones.

Search TwiCC's session history (full-text index). Use when you or the user want to find past conversations, look up what was discussed, or locate specific content across sessions.

Send a message (and optional attachments) to an existing TwiCC session. Use when you or the user want to continue a conversation, drop a follow-up from a script, or attach files.

Send the SAME message (and optional attachments) to several TwiCC sessions, selected by id and/or --spawned-by/--descendants/--siblings/--annotation. Use to broadcast a steering instruction, status request, or correction to a batch (e.g. every worker in an orchestration), or for a worker to message peers with --siblings self.

Inspect a single session — view metadata, read raw item content by line number, read user/assistant messages, list subagents, read its plan, or list/inspect its workflows. Use when you or the user want to examine a session, read conversation content, or explore subagent activity.

List sessions tracked by TwiCC, or batch-look up specific session_ids. Use when you or the user want to browse sessions, find a session ID, filter by project, or batch-fetch metadata for known ids.

Report the live TwiCC backend's status. Use when you or the user want to know whether TwiCC is up, diagnose a failing CLI command, or grab the PID/port.

Show the spawned-session tree around a session, rooted at its top-level ancestor, with session metadata, process state, and aggregate child/cost data.

Show API usage quotas and cost estimates per backend provider. Use when you or the user want to check utilization, rate limits, or spending.

Return the details of the session that owns the calling process. Use to discover your own TwiCC session_id from inside a Bash tool, to reference your own session.

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.

List all TwiCC workspaces, or batch-look up specific workspace_ids. Use when you or the user want to browse workspaces, find a workspace ID, or batch-fetch metadata for known ids.