v2.0.0

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.

v2.0.0-beta.3

docs: add Mochi CTA to site

v2.0.0-beta.2

Full Changelog: v2.0.0-beta.1...v2.0.0-beta.2

v2.0.0-beta.1

What's Changed

• chore: Bump github.com/mattn/go-runewidth from 0.0.19 to 0.0.20 by @dependabot[bot] in #369
• chore: Bump qs and netlify-cli in /docs by @dependabot[bot] in #364
• chore: Bump golang from 1.25.4-bookworm to 1.26.0-bookworm by @dependabot[bot] in #365
• chore: Bump the testing-deps group with 2 updates by @dependabot[bot] in #359
• chore: Bump github.com/spf13/cobra from 1.10.1 to 1.10.2 by @dependabot[bot] in #360
• chore: Bump github.com/gen2brain/beeep from 0.11.1 to 0.11.2 by @dependabot[bot] in #361
• chore: Bump github.com/charmbracelet/bubbles from 0.21.0 to 1.0.0 in the charmbracelet-deps group by @dependabot[bot] in #367
• chore: Bump actions/upload-artifact from 5 to 7 by @dependabot[bot] in #368
• chore: Bump actions/download-artifact from 6 to 8 by @dependabot[bot] in #366
• chore: Bump fastify and netlify-cli in /docs by @dependabot[bot] in #370
• chore: Bump github.com/buger/jsonparser from 1.1.1 to 1.1.2 by @dependabot[bot] in #371
• chore: Bump rollup from 4.52.4 to 4.60.0 in /docs by @dependabot[bot] in #372
• chore: Bump preact from 10.27.2 to 10.28.2 in /docs by @dependabot[bot] in #362
• feat: terminal ui upgrade by @jahvon in #383
• chore: Bump docker/login-action from 3 to 4 by @dependabot[bot] in #375
• chore: Bump docker/setup-qemu-action from 3 to 4 by @dependabot[bot] in #374
• chore: Bump golang from 1.26.0-bookworm to 1.26.1-bookworm by @dependabot[bot] in #373
• chore: Bump docker/setup-buildx-action from 3 to 4 by @dependabot[bot] in #376
• chore: Bump codecov/codecov-action from 5 to 6 by @dependabot[bot] in #378
• chore: Bump mvdan.cc/sh/v3 from 3.12.0 to 3.13.0 by @dependabot[bot] in #381
• chore: Bump github.com/mattn/go-runewidth from 0.0.20 to 0.0.21 by @dependabot[bot] in #382
• chore: Bump the testing-deps group across 1 directory with 2 updates by @dependabot[bot] in #379
• chore: Bump golang.org/x/sync from 0.19.0 to 0.20.0 in the experimental-golang-deps group across 1 directory by @dependabot[bot] in #377
• feat: Add execution history tracking with persistent data store by @jahvon in #384
• feat: Add background execution with --background flag and run management by @jahvon in #385
• feat: Overhaul MCP server for 2025-11-25 spec and add llms.txt doc by @jahvon in #386
• feat!: use standard --flag syntax for executable arguments (#325) by @jahvon in #387
• feat: Add git workspace support with clone, update, and force pull by @jahvon in #388

Full Changelog: v1.1.3...v2.0.0-beta.1

v1.1.3

Changelog

Documentation updates

• dd65436 docs: migrate to vitepress (#350)
• 6e68b79 docs: update readme icon path

Miscellaneous

• be24123 chore: Bump actions/checkout from 5 to 6 (#346)
• babdc27 chore: Bump actions/download-artifact from 5 to 6 (#336)
• 2d7a407 chore: Bump actions/upload-artifact from 4 to 5 (#334)
• ee55fbb chore: Bump github.com/expr-lang/expr from 1.17.5 to 1.17.7 (#348)
• b001240 chore: Bump github.com/mark3labs/mcp-go from 0.41.1 to 0.43.1 (#344)
• c560528 chore: Bump github.com/onsi/ginkgo/v2 from 2.25.3 to 2.27.2 in the testing-deps group (#338)
• 1c5028b chore: Bump github/codeql-action from 3 to 4 (#337)
• e2df7a2 chore: Bump golang from 1.25.2-bookworm to 1.25.4-bookworm (#345)
• 1b53487 chore: Bump golang.org/x/crypto from 0.41.0 to 0.45.0 (#342)
• eadb7d0 chore: Bump golang.org/x/sync from 0.17.0 to 0.18.0 in the experimental-golang-deps group (#343)
• 39a67de chore: Bump mdast-util-to-hast from 13.2.0 to 13.2.1 in /docs (#351)
• 75d60d9 chore: Bump vite from 5.4.20 to 5.4.21 in /docs (#352)
• 425b3f3 chore: add netlify docs release workflows
• 82db67c chore: fix docs deploy workflow (#353)
• 6f51253 refactor: enable cli extensions with public packages (#354)
• 8b34cb6 refactor: remove desktop code (#355)

v1.1.2

Changelog

New features

• 21f55c9 feat(cache): add --global flag for overriding scope (#330)

Bug fixes

• b3ad06a fix(cli): force the tui when --output == tui (#331)

Miscellaneous

• fa976b2 chore(ci): automatically determine release image tag
• ff3b944 chore(issues): add assignee to issue template

v1.1.1

Changelog

New features

• a222fdc feat: log a warning when an invalid executable is found (#321)
• 0bfefe7 feat: visibility flag for browse cmd (#323)

Bug fixes

• c924b26 fix: assume the flowfile context when expanding refs for serial/parallel (#322)
• b5ad499 fix: environment variables should be expanded when ws dir prefix is used (#317)
• e51df0c fix: evaluate conditionals right before execution (#316)
• 4c3cca0 fix: exec name alias should be respected when ws verb aliases are set (#324)
• 9a39db0 fix: include ws in nameless refs with a ns (#320)
• 5db0f18 fix: launch uri respect app prefixes (#319)

Miscellaneous

• 1a922cc docs: prerender documentation site content (#318)
• 21b5a0e chore: Bump actions/checkout from 4 to 5 (#296)
• 4f71826 chore: Bump actions/download-artifact from 4 to 5 (#295)
• 540535c chore: Bump actions/setup-go from 5 to 6 (#308)
• 3e618c0 chore: Bump actions/upload-pages-artifact from 3 to 4 (#299)
• 6834ac2 chore: Bump github.com/charmbracelet/bubbletea from 1.3.6 to 1.3.10 in the charmbracelet-deps group (#311)
• 30f62a1 chore: Bump github.com/mark3labs/mcp-go from 0.37.0 to 0.38.0 (#298)
• 3189a0c chore: Bump github.com/mark3labs/mcp-go from 0.39.1 to 0.41.1 (#312)
• 2e03a5d chore: Bump github.com/mattn/go-runewidth from 0.0.16 to 0.0.19 (#313)
• 0500e38 chore: Bump github.com/spf13/cobra from 1.9.1 to 1.10.1 (#314)
• 2e1cfad chore: Bump github.com/spf13/pflag from 1.0.7 to 1.0.9 (#294)
• 5fcb2b0 chore: Bump go.etcd.io/bbolt from 1.4.2 to 1.4.3 (#300)
• 06a737b chore: Bump go.uber.org/mock from 0.5.2 to 0.6.0 (#301)
• 33190a3 chore: Bump golang from 1.25.0-bookworm to 1.25.1-bookworm (#309)
• 5d7c1b0 chore: Bump golang.org/x/sync from 0.16.0 to 0.17.0 in the experimental-golang-deps group (#310)
• 4ee39ee chore: Bump the testing-deps group with 2 updates (#297)
• 833580d chore: Bump vite from 6.3.5 to 6.3.6 in /desktop (#302)
• ecb17a5 chore: bump go version (#327)
• 33ae838 chore: fix docker release config
• 82cdb56 chore: replace release process with flow execs
• 1e09297 refactor(desktop): replace view routing with wouter (#277)

v1.1.0

New since v1.0.0

• Import executables from Makefiles, Docker Compose files, and package.json scripts
• Model Context Protocol Server (flow mcp) for AI assistant integration
• Environment file support - Load .env files as parameters or global workspace settings
• Enhanced templating with new file functions and unified Go text/template support across all contexts
  • Note: Existing render templates may need updates for the new templating system
• New vault backends - External (CLI-based), keyring, and unencrypted storage options
• Nameless executables within namespaces (referenced as ws/ns:)
• Custom verb aliases - Define verb mappings on executables or as global workspace settings
• Parameter output files - Save argument/parameter values to temporary files
• Expanded verb library with more natural language options
• Improved serial/parallel inheritance for arguments and parameters
• Fixed executable log archiving and various workspace discovery improvements

Full Changelog: v1.0.0...v1.1.0

v1.0.3

What's Changed

• fix: child execs should inherit parent argument values by @jahvon in #284
• fix: disable markdown viewer when rendering as non-interactive by @jahvon in #285
• feat: Add a MCP server under the mcp subcommand by @jahvon in #279
• chore: Bump codecov/codecov-action from 3 to 5 by @dependabot[bot] in #261
• chore: Bump mvdan.cc/sh/v3 from 3.11.0 to 3.12.0 by @dependabot[bot] in #263
• test: move test flowfile builder by @jahvon in #286
• chore: update dependencies by @jahvon in #287
• fix: cli completions should filter by verb by @jahvon in #288
• docs: switch to history router by @jahvon in #289

Full Changelog: v1.0.2...v1.0.3

v1.0.2

Changes from #278 including:

• More executable verbs: Added many more executable verbs and removed a lot of the default alias groups. This is to enable more natural language definitions without the need to override so many verb aliases
• Customizable verb alias groups: Define your own verb alias mappings directly on an executable
• Env temporary files: Parameters and argument values to be saved to a temporary outputFile
• Nameless execs: add support for nameless execs when a namespace is defined (referenced like ws/ns:)
• Bug fixes: executable log archiving now works, workspaces now exclude problematic directories by default, warnings are logged for duplicate execs, import directory handling, and other small issues related to recent changes

Full Changelog: v1.0.1...v1.0.2