flow v1.0.0 🎉

This major release brings significant improvements to secret management, enhanced CLI consistency, and numerous stability fixes that make flow production-ready for automating your development workflows.

Just getting started with flow? Begin with new Core Concepts guide to understand how flow works, then build your first automation with Your First Workflow!

🔐 Breaking Changes

New Vault System

flow v1 introduces a completely redesigned vault system with support for multiple encryption backends:

• AES256 Encryption (default) - Simple symmetric encryption with auto-generated keys
• Age Encryption - Asymmetric encryption for team collaboration

Migration Required: If you're using a pre-v1 vault, migrate your secrets:

flow vault create new-vault --key-env MY_NEW_VAULT_KEY
flow vault migrate new-vault

Templating Engine Updates

• Templates and request transformations now use the [Expr language](https://expr-lang.org/) instead of Go templating evaluations
• This provides more powerful conditional logic and data manipulation capabilities

CLI Command Changes

Several commands have been renamed for better consistency:

• flow store → flow cache
• flow secret vault → flow vault
• flow browse == flow library
• Various subcommands and option updated for improved clarity and consistency

Other Breaking Changes

• Default executable timeout removed (was 30 minutes) - executables now run indefinitely unless explicitly configured
• Organization migration: flow has moved to the flowexec organization on GitHub

✨ New Features

Enhanced Secret Management

• Create multiple vaults with different encryption types
• Switch between vaults easily: flow vault switch production
• Cross-vault secret access: secretRef: "production/api-key"
• Team-friendly Age encryption support with recipient keys

Nameless Executables

Define executables without names that can be referenced by verb alone:

executables:
  - verb: build
    exec:
      cmd: make build

Run with: flow build

Parameter Overrides

Override environment variables directly from the command line:

flow deploy myapp --param API_KEY=value --param DEBUG=true

Extended File Format Support

flow files now support additional extensions:

• .flow
• .flow.yml
• .flow.yaml

Custom Workspace Verb Aliases

Define custom verb mappings at the workspace level for more natural command syntax specific to your projects.

🔧 Improvements & Fixes

Stability Enhancements

• Fixed log output issues in CI environments
• Resolved launch executable URI expansion bugs
• Fixed render executable viewer opening
• Corrected flowfile extension validation
• Multiple execution-related bug fixes

Logging Improvements

• Enhanced log formatting and output
• Better CI/CD integration with proper log streaming
• Improved error messages and debugging information
• Added visual indicators in library for runnable executables

🚀 Ecosystem Updates

GitHub Actions Integration

Introducing the flow-execute GitHub Action for running flow executables in your CI/CD pipelines:

- uses: jahvon/flow-action@v1
  with:
    executable: 'build app'

Desktop Application Foundation

Initial groundwork laid for the upcoming flow Desktop application - stay tuned for future releases!

📦 Dependency Updates

Key dependency upgrades in this release:

• golang → 1.24.4
• github.com/expr-lang/expr → 1.17.5
• github.com/charmbracelet/bubbletea → 1.3.4
• github.com/spf13/cobra → 1.9.1
• golang.org/x/crypto → 0.35.0
• golang.org/x/net → 0.38.0
• mvdan.cc/sh/v3 → 3.11.0

👥 Join Our Community

Launched a Discord community for flow users! Join us to:

• Get help with flow configurations
• Share your workflows and automations
• Contribute to flow's development
• Connect with other developers streamlining their workflows

Join the flow Discord → https://discord.gg/CtByNKNMxM

📚 Documentation

Complete documentation overhaul for v1.0 at flowexec.io:

• Redesigned information architecture for better navigation
• Comprehensive vault management guide
• Updated CLI command reference for all new and changed commands
• Expanded executable type examples
• Enhanced getting started guides
• Updated GitHub repo documentation

Upgrading to v1

1. Update flow to the latest version
2. Migrate any existing vaults using flow vault migrate
3. Update any scripts using renamed commands (store → cache)
4. Review template files if using custom templating
5. Run flow sync to ensure all executables are properly indexed

Full Changelog: v0.6.3...v1.0.0