Skip to content

Commands ​

These are the user-facing commands the extension contributes to VS Code. Run them from the Command Palette (Ctrl+Shift+P / Cmd+Shift+P) unless the table says they live in a menu.

Standalone CLI ​

The CLI's run-history inspection commands are documented in the ctrlyoke CLI reference. To list executing workflows and check whether their runner processes are alive, use ctrlyoke status; pass --workflow <key-or-name> and --run <ref> to narrow the result, or --json for machine-readable output; each row's liveness names why a run is stale. For recorded run output, history show --json emits NDJSON; --summary keeps attempt records compact, --events emits one line per output event, and --limit/--cursor/--tail bound everything a read emits to one page of one attempt. Agents should use these JSON forms because recorded tool output can contain nested ctrlyoke boxes that make rendered text ambiguous.

Dashboard and execution ​

CommandWhat it does
ctrlyoke: Open ctrlyoke PanelOpen the dashboard
ctrlyoke: RunRun the workflow loaded in the dashboard
ctrlyoke: Pause ExecutionPause the current run
ctrlyoke: Resume ExecutionResume a paused run
ctrlyoke: Stop ExecutionStop the current run
ctrlyoke: Resume SessionPick a previous run's harness session and resume it
ctrlyoke: Search ctrlyoke HistoryOpen the dashboard's run-history search
ctrlyoke: Show Output PanelShow the ctrlyoke log in VS Code's Output panel

Workflow authoring ​

CommandWhat it doesShortcut (dashboard focused)
ctrlyoke: New Workflow from TemplateOpen the template pickerCtrl+Shift+N / Cmd+Shift+N (dashboard)
ctrlyoke: New Blank WorkflowClear the current workflow and start freshCtrl+N / Cmd+N (dashboard)
ctrlyoke: Create New Custom TemplateOpen the template picker's create-template form
ctrlyoke: Select Prompt FilePick a workflow or prompt file in the workspace and load it
ctrlyoke: Queue Prompt FilePick a workflow or prompt file and append its steps to the queue

These shortcuts work while the ctrlyoke dashboard has focus, outside a text field or editor.

The prompt editor's convert button writes a step prompt to a file under .ctrlyoke/prompts/ and replaces the inline prompt with a reference to it. Script templates for end conditions are created from the condition editor in the dashboard, not from a command.

Save As ​

Save As writes a durable workflow definition at the destination you choose. It copies inline @, #selection:, and #sym references that point into generated attachments or prompt stores into a sibling <workflow>.assets/ directory, rewriting those references to the exported paths. It inlines lone step prompt values that resolve to generated prompt files, including empty files. Ordinary repository references remain unchanged. The exported pair — the workflow file and its sibling <workflow>.assets/ directory — can be moved or copied to another directory or repository and still resolve, provided they travel together. The pair carries generated dependencies, not the repository it operates on: @src/foo.ts, committed prompt files, and .ctrlyoke/scripts/** references remain dependencies of the surrounding repository by design.

Run with ctrlyoke submenu ​

Right-click a .ctrlyoke.yaml, .ctrlyoke.yml, .ctrlyoke.json, or .prompt.md file in the Explorer or on its editor tab, or use the play-icon Run with ctrlyoke menu in the editor title bar:

Menu itemWhat it does
Run with ctrlyokeSave the file if needed, load it, and run it
Load in ctrlyokeLoad the file into the dashboard without running it
Queue Steps with ctrlyokeAppend the file's steps to the end of the active queue
Queue Steps Next with ctrlyokeInsert the file's steps after the current step

Queue Steps and Queue Steps Next are hidden until the active queue already contains at least one step. These items are menu-only and do not appear in the Command Palette.

Adding context to the prompt editor ​

These menu items insert a reference into the dashboard's prompt editor. They are menu-only.

Menu itemWhere it appears
Add File to ctrlyokeExplorer file context menu, editor tab context menu, Source Control changed files
Add Directory to ctrlyokeExplorer folder context menu
Add Selection to ctrlyokeEditor and line-number context menus when text is selected
Add Symbol to ctrlyokeEditor and line-number context menus when nothing is selected
Add Output Selection to ctrlyokeOutput panel context menu when text is selected
Add Output Channel to ctrlyokeOutput panel context menu when no text is selected
Add Commit to ctrlyokeTitle bar ... menu and tab context menu of a commit's diff

A commit's diff is what opens when you click a commit in the Timeline view or the Source Control Graph, including Open Commit's multi-file diff.

Source Control ​

CommandWhat it does
ctrlyoke: Generate Commit Message with ctrlyokeGenerate a commit message into the Source Control input box; text already in the box guides the message. Also a button in the Source Control title bar for Git repositories
ctrlyoke: Cancel Commit Message GenerationCancel a generation in progress (replaces the generate button while it runs)

Workspace, worktrees, and usage ​

CommandWhat it does
ctrlyoke: Initialize WorkspaceCreate or repair .ctrlyoke/ and its generated .gitignore
ctrlyoke: Show Getting StartedReopen the Getting Started walkthrough
ctrlyoke: Review Workspace Settings That Run ProgramsReview which workspace settings that run programs are trusted on this machine
ctrlyoke: Install CLI for Use Outside VS CodeOpen a terminal with the matching npm install -g ctrlyoke@<version> typed in, not run
ctrlyoke: Manage WorktreesOpen the dashboard to manage ctrlyoke worktrees
ctrlyoke: Refresh Harness UsageRefresh harness usage and quota information
ctrlyoke: Refresh Workspace StatisticsRecompute the workspace statistics shown in the dashboard

Hosted dashboard server ​

CommandWhat it does
ctrlyoke: Start Hosted Dashboard ServerStart the browser dashboard server, the same as the toggle in the dashboard's Server settings. A notification confirms it with the token masked; the full URL and access token are in Server settings.
ctrlyoke: Stop Hosted Dashboard ServerStop the server and disconnect every browser

Regenerating the access token is available only from the Server settings tab.

License ​

CommandWhat it does
ctrlyoke: Activate Pro LicenseOpen the dashboard's license settings
ctrlyoke: Activate Offline (Air-Gapped) LicenseImport an offline license file without network access
ctrlyoke: Deactivate Pro LicenseOpen the dashboard's license settings
ctrlyoke: Manage LicenseOpen the dashboard's license settings

Source-available under the ctrlyoke Commercial License.