flow v2

What's New

Rebuilt Terminal UI — The browse library is now a full-featured table view with richer filtering and inline previews. All TUI views have gotten the same treatment - modern and clean for your everyday needs.

Background Execution — Pass --background to any flow exec command to detach immediately and get a run ID back. Attach, tail, or kill it later with flow logs attach|kill <run-id>.

Persistent Execution History — Every run is recorded to a local store. flow logs is now a filterable history viewer — search by workspace, verb, status, or time range. New subcommands: clear, attach, kill.

Git Workspaces — Add a remote Git repo directly as a workspace. Flow clones it locally and keeps it under management. Pull updates anytime with flow workspace update or flow sync --git.

MCP Server Overhaul — Rewritten to the 2025-11-25 MCP spec. Adds new tools (write_flowfile, get_workspace_config), new resources, cursor-based pagination, structured error responses, progress notifications, and an llms.txt index at flowexec.io/llms.txt.

Windows Support — Flow now runs natively on Windows with PowerShell/batch execution, Windows-native process management, and .zip release archives.

Smaller Additions

• flow schema — validate flowfiles and workspace configs before running
• flow cli update — check for updates and self-update in place
• Annotations — attach key-value metadata to executables/workspaces and filter by it in browse and workspace list
• --yes flag — skip confirmation prompts everywhere, useful in CI
• Structured output everywhere — all commands support --output=json|yaml with consistent error envelopes
• --vault on flow secret — target a specific vault without switching first
• Template --set flag — pre-fill template fields to skip interactive prompts
• flow template remove — remove a template by name

Bug Fixes

• TUI container hang on initialization in certain terminal environments
• ANSI escape codes appearing in non-TTY logger output
• Workspace local path normalization (tilde expansion, trailing slashes)
• Improved error messages for missing workspace, namespace, and executable paths

Breaking Changes

Four changes require updates to existing usage.

1. fromFile removed — replace with imports:
2. Executable argument syntax changed — use -- before args, prefix flags with --
3. Default workspace removed — an explicit active workspace is now required
4. Log file paths changed — v1 log archives are not migrated automatically

Resources

• Examples Gallery — browse real-world flowfiles covering common patterns and use cases
• Breaking Changes Guide — migration steps for v1 users
• Full Changelog: v1.1.3...v2.0.0

Coming Soon

Mochi — your workflows, neatly wrapped. A desktop app built on Flow that adds workflow auto-discovery, AI enrichment, and a unified UI across all your projects. Sign up for early access at mochiexec.io.