v0.4.0

Highlights

• Script your agent fleet. The new paneflow CLI turns Paneflow into a control plane: paneflow up builds a whole agent workspace from one declarative spec, and paneflow flow runs multi-agent pipelines from a flow.toml (readiness barriers, fan-out, data capture between steps). Nothing is ever submitted to an agent without an explicit double opt-in: you stay in the loop.
• One git worktree per agent. Declare worktree = "branch" and every agent gets its own isolated checkout, with .env files copied, a port offset per pane, and automatic cleanup when the workspace closes. Parallel agents stop stepping on each other's diffs.
• The grid routes your attention. A waiting agent now glows, its tab shows a dot, the desktop notification carries the actual question, and Ctrl+Shift+J jumps straight to the next agent that needs you. Hover the pane badge to read the question without switching focus.
• A cleaner cockpit. The Agents view is rebuilt as a Codex-style cockpit, and every mode gets full-height rails with a floating title bar and quieter chrome.

Changelog

Added

• paneflow CLI: a scriptable control plane over the IPC socket. ls, read and search expose pane scrollback with a unified target selector; new, select, split and focus drive the layout; send feeds text to a pane behind a scripting gate and never auto-submits; key sends a single non-submitting keystroke; wait blocks on pane readiness as an orchestration primitive.
• paneflow up: declarative agent workspaces (per-pane cwd, agent to launch, prompt prefill), backed by a workspace.up IPC handler.
• Worktree-per-agent: worktree = "branch" in up gives each pane its own git worktree, with .env* copy, an optional setup command, a ${port_offset} variable, clean teardown at workspace close and pruning of orphaned worktrees at startup.
• paneflow flow: flow engine for multi-agent pipelines. flow.toml declares spawn steps with ready.pattern barriers, gated send steps, foreach fan-out and fan-in, capture to pass data between steps, plus validation with cycle detection, --dry-run, reporting, exit codes and state resume.
• Attention routing: waiting-agent glow and tab dot, the agent's question in the desktop notification, Ctrl+Shift+J to cycle to the next waiting agent across workspaces, hover peek on the pane badge.
• Persistent agent-notification hooks: paneflow hooks setup installs a durable hook, paneflow hooks status reports each agent honestly, and the launch shim defers to a persistent hook instead of injecting an ephemeral one.
• Turn-end desktop notification when the window is unfocused.

Changed

• Agents view rebuilt as a Codex-style cockpit: rail sections (Search, Pinned, Projects, Chats), free chats anchored to the home directory, a contextual top bar with a thread overflow menu, and unified selection/empty states.
• Cockpit chrome across every mode: full-height rails with a floating rail-confined title bar, the update call-to-action moved into the sidebar in Cli/Agents, a single-row Diff toolbar, and quieter text inputs.
• The sessions sidebar now follows the active workspace instead of staying bound to the previous one.
• "PaneFlow Light" is temporarily out of the bundled theme set pending a light-theme redesign; configs naming it fall back to One Dark.

Fixed

• A literal --update-and-exit token passed as a CLI or hooks argument can no longer hijack the process into the self-updater.

Full changelog: https://github.com/ArthurDEV44/paneflow/compare/v0.3.9...v0.4.0

Note for v0.3.9 users: the v0.3.9 build shipped without an embedded update-verification key, and its in-app updater fails closed by design. To get v0.4.0, download it from this page (or your package manager path) manually - one-time step.

Full Changelog: https://github.com/ArthurDEV44/paneflow/compare/v0.3.9...v0.4.0