Make guided workspace interactive

Author: CurioCrafter

CHANGELOG.md

@@ -2,6 +2,22 @@
 
 ## Unreleased
 
+## 0.1.1 - 2026-04-25
+
+### Changed
+
+- Reworked the app around a guided workspace with setup, current step, live surface, and Ask Codex controls.
+- Made Plan Board steps interactive with ask, done, skip, observe, and blocked actions.
+- Made Mouse Plan guidance clearer for screen-share and isolated-browser workflows.
+- Regenerated public screenshots for first-run, guided workflow, Mouse Plan, and approval flow states.
+
+### Added
+
+- Added follow-up command, observe-current, and local plan-step update IPC methods.
+- Added tests for guided workflow helpers, manager follow-up commands, local plan updates, and observe-only Mouse Plan safety.
+
+## 0.1.0 - 2026-04-25
+
 ### Changed
 
 - Refactored the renderer into public-facing command-center components.
@@ -13,8 +29,6 @@
 - Added install, safety, architecture, troubleshooting, and release docs.
 - Added PR template, issue template guidance, and Dependabot configuration.
 
-## 0.1.0
-
 ### Added
 
 - Initial MIT-licensed release.

README.md

@@ -15,7 +15,7 @@ This project is independently built by Andrew Rainsberger. It is not an official
 
 ## What It Is
 
-CodexForWorkflow gives Codex a controlled place to help you work across screens. It can observe selected screens or windows, narrate what it sees, maintain a visible plan, propose mouse intent, and automate an isolated Playwright browser only when the safety policy allows it.
+CodexForWorkflow gives Codex a controlled place to help you work across screens. It opens into a guided workspace: connect Codex auth, choose a mode/source, describe the task, then follow the current step, Mouse Plan, approval queue, and verification loop.
 
 ## What It Is Not
 
@@ -30,11 +30,14 @@ CodexForWorkflow gives Codex a controlled place to help you work across screens.
 - Live Work Surface: a primary screen/browser canvas with secondary context strips.
 - Screen Share mode: observe-only guidance for the live desktop.
 - Isolated Browser mode: Playwright Chromium automation with approval gates.
-- Mouse Plan: visible target overlays before user-guided or browser-automated actions.
-- Plan Board: Codex-visible observe, decide, act/guide, and verify workflow steps.
+- Mouse Plan: visible target overlays with manual guidance in Screen Share or approved execution in Isolated Browser.
+- Interactive Plan Board: one active step at a time with ask, observe, done, skip, and blocked controls.
+- Ask Codex bar: quick follow-ups for what it sees, next step, where to click, and verification.
 - Workflow presets: guide a screen, automate a browser, compare research windows, or debug with an assistant.
 - Safety controls: pause, resume, stop, approvals, blocked domains, and credential/download gates.
 
+![CodexForWorkflow guided workflow](docs/screenshots/guided-workflow.png)
+
 ![CodexForWorkflow approval flow](docs/screenshots/approval-flow.png)
 
 ## Install

docs/ARCHITECTURE.md

@@ -15,11 +15,12 @@ flowchart LR
 
 ## Renderer
 
-The renderer is a command-center UI:
+The renderer is a guided command-center UI:
 
-- left rail for auth, workflows, and sources;
-- center work zone for the live work surface, secondary sources, and command bar;
-- right rail for plan board, mouse plan, approvals, and timeline.
+- left rail for setup: auth, mode, sources, and workflow presets;
+- center work zone for the current step banner, live work surface, secondary sources, and Ask Codex bar;
+- right rail for Guide, Approvals, Activity, and Details tabs;
+- Guide tab for the active Plan Board step, Mouse Plan controls, and step-level actions.
 
 Deterministic demo state powers README screenshots without using real desktop content.
 
@@ -34,6 +35,12 @@ The Electron main process owns privileged work:
 - policy and approval gating;
 - loopback bridge lifecycle.
 
+Renderer follow-ups use local IPC only:
+
+- `task:send-command` sends a follow-up prompt into the active Codex thread.
+- `task:observe-current` refreshes the isolated browser or pinned screen-share observations.
+- `plan-step:update` records local user progress and advances the next pending step when appropriate.
+
 ## Tool Boundary
 
 Screen tools observe only. Browser tools can act only in isolated browser mode. The task manager rejects browser-control tools when the session is in Screen Share mode.

docs/SAFETY.md

@@ -8,6 +8,7 @@ CodexForWorkflow is designed around clear separation between observation and con
 - Codex can inspect screenshots and propose guidance.
 - The app does not synthesize desktop mouse or keyboard input.
 - Mouse Plan overlays are guidance for the user, not live desktop automation.
+- `I did this` records the user's manual action and asks Codex to verify with another observation; it does not click or type on the desktop.
 
 ## Isolated Browser Mode
 

docs/screenshots/approval-flow.png

@@ -1,6 +1,6 @@
 {
   "name": "codex-for-workflow",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "productName": "CodexForWorkflow",
   "description": "Desktop command center for Codex-guided multi-screen workflows.",
   "author": "Andrew Rainsberger",