Stats
Actions
Tags
From varie-workstation
Manages Varie Workstation coding sessions: lists active sessions, dispatches commands to projects, creates/starts/resumes sessions, responds to prompts, stops/interrupts, captures screenshots.
How this skill is triggered — by the user, by Claude, or both
Slash command
/varie-workstation:workstationThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Control Varie Workstation coding sessions via `wctl`.
Control Varie Workstation coding sessions via wctl.
Before ANY routing or session work, check if a session is waiting for user input:
cat ~/.openclaw/workspace/pending-prompts.json 2>/dev/null || echo '{"prompts":[]}'
If prompts array is non-empty AND the user's message looks like a response (a number, "approve", "yes", "no", "reject", short answer, or references a project in the pending list):
→ This is a reply to a pending prompt. Go directly to "Responding to Session Prompts" section below.
If prompts array is empty OR user's message is clearly a new request (mentions a different project, asks to start/create something, etc.):
→ Continue to Smart Routing below.
When the user mentions working on a project (e.g., "work on my-api", "resume frontend work", "start auth refactor"), follow this decision tree silently — do NOT ask the user unless you hit an ambiguous case:
wctl list
(If daemon not running, tell user to start the Workstation app.)
Look at the repo field in each worker. Match the user's project mention against repo names (fuzzy — "frontend" matches "my-frontend-app", "api" matches "backend-api-service").
If session exists and task context aligns (user's request fits the current taskId/workContext):
→ wctl dispatch <session-id> "<user's message>"
If session exists but task context doesn't align (user wants to work on something different in the same repo): → Ask: "There's already a session for {repo} working on {taskId}. Should I send this to that session, or create a fresh one?"
If no session exists for the project: → Go to Step 3.
If multiple repos match (e.g., "api" could be frontend-api or backend-api): → Ask which one.
wctl discover
Find the project path from the discovered list, then:
wctl create <repo> <path> <task-id>
Derive task-id from the user's message (e.g., "work on auth refactor" → task-id: auth-refactor). Keep it short, lowercase, hyphenated.
After creation, confirm: "Started new session for {repo} ({task-id})."
If project not found in discover results, ask the user for the repo path.
| Command | Use |
|---|---|
wctl status --human | Check daemon alive |
wctl list | List sessions (JSON, for parsing) |
wctl list --human | List sessions (readable, for user) |
wctl dispatch <id> "<msg>" | Send message to existing session |
wctl dispatch-answers <id> <a1> <a2>... | Send multi-question answers. Use next:N for multi-select |
wctl create <repo> <path> [task] | Create new session |
wctl escape <id> | Send Escape key (cancel prompt/menu) |
wctl interrupt <id> | Send Ctrl+C (stop running process) |
wctl enter <id> | Send Enter key (confirm/dismiss) |
wctl screenshot <id> | Screenshot a session (focus + capture) |
wctl screenshot --screen | Screenshot main display |
wctl set-remote-mode on|off | Enable/disable remote mode (bridge auto-focus for screenshots) |
wctl discover | Scan for project repos |
When the user wants to stop, cancel, or interrupt a session:
| User says | Command |
|---|---|
| "stop session X", "cancel", "kill it", "abort" | wctl interrupt <id> (sends Ctrl+C) |
| "escape", "go back", "cancel prompt", "dismiss" | wctl escape <id> (sends Escape key) |
| "press enter", "confirm", "continue", "submit" | wctl enter <id> (sends Enter key) |
Strategy: If unsure, try escape first (safe — cancels UI prompts). If still stuck, use interrupt (harder — sends SIGINT).
To show the user what a session looks like:
# 1. Capture the session
wctl screenshot <session-id>
# Returns: { "status": "ok", "imagePath": "/path/to/screenshot.png" }
# 2. Send to user using the built-in message tool
To deliver the screenshot, use your built-in message tool (not bash) with action: "send" and mediaUrl pointing to the captured image path. The message tool is session-bound — it automatically targets the channel and user you're currently chatting with. No need to specify channel or target manually.
If the message tool is unavailable, fall back to the CLI:
openclaw message send --media <imagePath> --channel <channel> --target <target>
Replace <channel> and <target> with the values from the current conversation (e.g., telegram + the user's chat ID, or whatsapp + their phone number).
For full screen (e.g., to see Chrome, other apps): wctl screenshot --screen
When to use: User says "show me", "screenshot", "what does it look like", "what's happening in session X".
Always send the image via openclaw message send --media after capturing — wctl only saves the file locally.
wctl route (it may restart Claude and disrupt work).claude to messages — just pass the user's message as-is to dispatch.--human when showing output to user — JSON otherwise for your own parsing.wctl list and pending-prompts.json for ground truth.--chat-arrows 20 to select "Chat about this" and then dispatch their message as text. A stuck question modal is worse than falling back to chat.When Step 0 finds pending prompts and the user's message is a response:
The pending prompt has a project field. Use it to find the session:
wctl list
Find the session whose repo matches the pending prompt's project. Use its sessionId.
If multiple prompts are pending, match the user's message to the most relevant one (by project name mention or most recent).
Plan approval (4 options):
| User says | Dispatch |
|---|---|
| "1", "clear context", "bypass all" | wctl dispatch <id> "1" |
| "2", "bypass permissions", "yes bypass" | wctl dispatch <id> "2" |
| "3", "approve", "yes", "go ahead", "lgtm", "manually approve" | wctl dispatch <id> "3" |
| "reject", "no", feedback like "change X to Y" | Two steps: wctl dispatch <id> "4" then wait 2s then wctl dispatch <id> "<their feedback>" |
Default to option 3 ("yes, manually approve edits") when user says generic approval like "yes", "approve", "go ahead".
Important for option 4 (feedback/reject): This is a two-step process. First dispatch "4" to select the text input option, wait 2 seconds for the text prompt to appear, then dispatch the feedback text. Example:
wctl dispatch abc123 "4"
sleep 2
wctl dispatch abc123 "don't modify the database schema"
Question — ALWAYS dispatch the OPTION NUMBER, never text:
Look up the user's answer in the pending prompt's questions array and find the matching option number. Example: if options are ["1. Night", "2. Day", "3. Morning"] and user says "night", dispatch "1" (not "night").
| User says | Action |
|---|---|
| A number ("1", "2") | Dispatch that number directly |
| A word matching an option label ("night", "dog") | Find the option number and dispatch the NUMBER |
| Free text not matching any option | Dispatch the text (for "Other" option) |
Single question: Use regular dispatch: wctl dispatch <id> "2"
Multiple questions: Use dispatch-answers — it sends each answer without Enter (Claude auto-advances on single-select), then sends Enter at the end to submit. Map EACH answer to its option NUMBER, then pass them all in one command:
wctl dispatch-answers <id> 2 1 3
This sends: "2" → wait → "1" → wait → "3" → wait → Enter (submit). No chaining or sleep needed — timing is handled internally.
Multi-select questions (checkboxes — check the multiSelect field in pending-prompts.json): Typing a number toggles it on/off but does NOT advance (cursor stays at position 1). After selecting all options, use next:N to arrow-down N times to the "Next"/"Submit" button and press Enter. N = the number of options for that question (including "Other"), from questions[i].options.length.
wctl dispatch-answers <id> 1 2 next:5 2
This sends: "1" (toggle) → "2" (toggle) → arrow-down×5 to "Next" → Enter → "2" (next question, single-select) → Enter (submit all).
Example with 4 questions (multi/5opts, single, single, multi/5opts):
wctl dispatch-answers <id> 1 4 next:5 2 1 1 3 next:5
Each next:N is self-contained — N is always questions[i].options.length for that specific multi-select question.
How to tell if a question is multi-select: The pending prompt's questions array has a multiSelect field per question. If multiSelect: true, you MUST add next:N after their selections. If multiSelect: false (or missing), it's single-select and auto-advances — no next needed.
If the last question is multi-select, use next:N as the last token — it will click "Submit" instead of "Next" (same button position). The final Enter to confirm all answers is sent automatically after all tokens.
"Chat about this" — at the very bottom of the question modal (below all options and Next/Submit), there's a "Chat about this" option. Arrow keys do NOT wrap/circulate, so you can safely overshoot. Use --chat-arrows N to select it. Calculate N based on the first question only:
--chat-arrows K+1 (extra arrow for Next button)--chat-arrows K# Example: first question is multi-select with 5 options → 6 arrows
wctl dispatch-answers <id> --chat-arrows 6
# Example: first question is single-select with 3 options → 3 arrows
wctl dispatch-answers <id> --chat-arrows 3
When using --chat-arrows, no answer tokens are needed — it replaces the entire answer flow.
FALLBACK RULE: If you are unsure how to map the user's answers to option numbers, or the user's message is vague/unclear, always use --chat-arrows instead of guessing. This lets the user follow up with a simple text prompt rather than getting stuck on a broken selection. Since arrows don't wrap, you can safely use --chat-arrows 20 if unsure about the exact count — it will land on "Chat about this" regardless.
After selecting "Chat about this", immediately dispatch the user's message as a follow-up:
wctl dispatch-answers <id> --chat-arrows 20
sleep 3
wctl dispatch <id> "<user's original message>"
After dispatching, tell the user: "Sent response to {project}."
wctl list to show valid IDswctl (the CLI that bridges OpenClaw to Workstation):
# wctl ships with Workstation — symlink it to your PATH:
ln -sf /path/to/varie-workstation/openclaw/wctl.js ~/.local/bin/wctl
chmod +x ~/.local/bin/wctl
cp -r workstation ~/.openclaw/workspace/skills/workstation
wctl statuswctl set-remote-mode on~/.openclaw/workspace/pending-prompts.json — this enables bidirectional question/approval flows from your phone.wctl status --human # Should show "Workstation is running"
wctl list --human # Should list active sessions (if any)
This skill requires the Varie Workstation app — an Electron-based multi-session Claude Code orchestration environment. The skill is the mobile control layer: it lets you manage Workstation sessions from Telegram, WhatsApp, or any OpenClaw channel.
| Dependency | What it does | Required? |
|---|---|---|
| Varie Workstation | Electron app hosting Claude Code terminals | Yes |
wctl CLI | Bridges OpenClaw commands to Workstation's Unix socket | Yes (ships with Workstation) |
| OpenClaw-Workstation bridge | Forwards session events (questions, approvals) to OpenClaw for mobile notifications | Yes (bundled in Workstation) |
Without Workstation running, the skill will report "daemon not running" for all commands.
wctl communicates with Workstation via a local Unix socket (/tmp/varie-workstation.sock). No network calls — all traffic is local.~/.openclaw/workspace/pending-prompts.json (read-only) — This file is read on every invocation (Step 0) to check if any Claude Code session is waiting for user input. It is written by the OpenClaw-Workstation bridge, not by this skill. Contents: question text, option labels, and project identifiers from active sessions. No credentials, secrets, or user data. The file may not exist until the bridge creates it — the skill handles this gracefully with a fallback empty response.wctl screenshot <id>) capture only the specific Workstation terminal window for the targeted session.wctl screenshot --screen) capture the entire display, which may include unrelated windows and sensitive content. This command is only executed when the user explicitly requests a full-screen capture (e.g., "screenshot my screen", "show me everything").~/.openclaw/media/ with a 30-minute TTL cleanup.wctl interrupt (Ctrl+C) is reserved for explicit user requests — the skill never sends it autonomously.openclaw message send routes media through your configured OpenClaw channel (Telegram/WhatsApp). Images traverse the channel provider's servers but are only sent to the requesting user's conversation.| Endpoint | Protocol | Data Sent |
|---|---|---|
/tmp/varie-workstation.sock | Unix socket (local) | Session commands (list, dispatch, create, screenshot) |
~/.openclaw/workspace/pending-prompts.json | Local file read | None (read-only) |
openclaw message send --channel --target | OpenClaw channel (Telegram/WhatsApp) | Screenshot images (when user requests) |
No external APIs are called directly by this skill. All network communication goes through OpenClaw's channel layer.
This skill controls local Claude Code sessions running inside the Varie Workstation app. All communication is via local Unix socket — no data leaves your machine unless you request a screenshot, which is sent through your configured OpenClaw messaging channel. Only install if you trust the Varie Workstation app and your OpenClaw channel configuration.
@masqueradeljb
npx claudepluginhub varie-ai/workstation --plugin varie-workstationLaunches and manages Claude Code, Codex, or Pi worker sessions as sub-processes. Useful for project managers that delegate tasks, assign work, monitor progress, review tool calls, and collect results via the `csd` CLI.
Unified session management for Claude Code: list active sessions, check inbox, and broadcast messages across sessions. Explicit /session invocation only.
Spawns and manages persistent tmux-based Claude Code CLI sessions with bidirectional communication. Subcommands: spawn, send, read, status, list, kill for parallel peer orchestration and multi-turn steering.