Skip to content
Development
Command

/init

Initialize a Wakeflow workspace here, or bring an existing one back to what its configuration implies

From plugin
wakeflow
54 skills4 commands1 MCP
> /plugin marketplace add GxFn/Wakeflow
> /plugin install wakeflow@gxfn

Command definition

init.md
description: Initialize a Wakeflow workspace here, or bring an existing one back to what its configuration implies
argument-hint: "[program name]"

Set up or repair the Wakeflow workspace for this directory.

On a directory without a workspace, read that skill's `references/first-run.md` before asking anything: the session you are in only bootstraps and never becomes the Controller; it ends with the handover card.

Load the `wakeflow-controller` skill and follow its "Step 0 - Initialize or maintain the workspace" section; the depth is in its `references/workspace-and-windows.md`.

First tool call: `wakeflow_maintain_workspace` in preview, after you have asked the user for the choices the intent needs (program identity, repositories, surfaces, storage root) - on an existing workspace, preview the reconcile intent instead and report what it found. The fresh-initialize `selection` has six parts - `program`, `presentation`, `topology` (repositories, support surfaces, windows), `storage`, `governance`, `hosts` - and its exact shape is the tool's input schema in your tool list: build the request from that schema, never from plugin files on disk (every `selectionKey` in it is unique across repositories, surfaces and windows). `hosts.claude-code.windowTransport` is the window transport - `tmux` panes or `desktop` sessions in the desktop app's Code tab: propose the one this session's surroundings support (desktop when it has the desktop app's session tools, tmux otherwise), say what each means, and let the user pick the other one if they prefer; one transport per workspace. A later `reconfigure` can switch the transport when no Demand is active and no worktree pod is open; afterwards you relaunch and register every window with the new transport's helper. A refusal names the failing path and rule (`details.schema`, for example `required:storage`); fix that field and preview again. Recommend `owner-managed` for every repository unless the user asks for Wakeflow's managed block, and say that a committed block is seen by every clone. `fresh-legacy-residue-present` lists what it found as `fresh-legacy-residue-<kind>` codes; the user removes residue themselves - a sibling `../wakeflow-ledger` directory that is another workspace's live ledger is not residue. Residue listed under a repository root is removed by the user before a window is launched there. When the user wants to add a product repository to an existing workspace, preview the reconfigure intent the reference describes for that. When they want a repository taken out of Wakeflow, or Wakeflow stopped here, preview the `detach-repository` or `detach-workspace` intent the reference describes - never delete Wakeflow's files by hand. The directory must already be a Git repository of its own; if the preview reports `gitignore-git-repository`, tell the user, run `git init` there yourself once they agree, and preview again.

Preview writes nothing. Show the user the plan and every blocker it returned, apply only with exactly what that preview returned, and only after they say to.

Then continue with "Step 1 - Open windows and register their bindings": launch each window the result asks for and register what you observed with `wakeflow_register_window_binding`.

Read more
@gxfn
Ships withwakeflow

A disciplined control loop for multi-window agent work — every step traced, every result reviewable.

54 skills1 MCP
Get the whole plugin

Stars on GitHub

Momentum

stars in total
5
Star history of GxFn/Wakeflow on GitHub, a chart by star-history.com

Other commands on wakeflow.

next

next

Command

Advance the current Wakeflow Demand through the Controller's own steps until a stop point

@gxfn@gxfnInstall Command
pod

pod

Command

Create a Wakeflow pod for parallel work, or close one after its branch has been merged or abandoned

@gxfn@gxfnInstall Command
status

status

Command

Report the Wakeflow workspace state, what is next and who owns it, and verify it strictly when something looks wrong

@gxfn@gxfnInstall Command

More commands from other plugins.

build
Auto-invoked

build

Command

Implement tasks incrementally — build, test, verify, commit. Add "auto" to run the whole plan in one approved pass.

@addyosmani@addyosmaniInstall Command