Skip to content

Releases: onflow/flow-cli

v2.9.0

Choose a tag to compare

@jribbink jribbink released this 22 Oct 02:09
c5a654c

This release brings the Flow CLI in sync with the mainnet Forte network upgrade (October 22, 2025), establishing Flow as the home for AI-native, autonomous applications. Forte empowers developers and AI agents with protocol composability and native automation—making user-owned, trustless workflows a reality.

What's New in Forte:

  • 🧩 Flow Actions - Composable DeFi building blocks for autonomous agents (swap, source, sink, flasher, oracle)
  • Scheduled Transactions - Native time scheduler enabling true on-chain automation
  • 🤖 Flow Agents - User-owned, autonomous execution triggered by native events
  • 🏗️ New CLI Commands - Full tooling support for managing scheduled transactions
  • 📦 Project Scaffolds - Ready-to-use templates for Flow Actions development

Forte enables fully autonomous, composable applications that execute on-chain without off-chain bots or custodians.

⬆️ Install or Upgrade

Follow the Flow CLI installation guide for instructions on how to install or upgrade the CLI.

⭐ Features

Scheduled Transactions Manager Commands

The Flow CLI now supports Scheduled Transactions, Flow's native time scheduler that enables autonomous, time-based transaction execution directly on-chain—like cron for blockchains. Part of the mainnet Forte network upgrade, this feature allows developers and AI agents to build fully automated workflows without relying on off-chain infrastructure.

Use Cases:

  • Recurring Payments - Automate subscription payments, salaries, or DCA strategies
  • AI-Driven Agents - Enable autonomous agents to proactively rebalance, settle, and sweep on schedule
  • Automated Arbitrage - Schedule price-dependent swaps across DEXs
  • Time-Based Logic - Unlock tokens, distribute rewards, or trigger governance actions
  • DeFi Workflows - Combine with Flow Actions for complex automated strategies

🧩 Key Commands

  • Manager Resource Setup

    Initialize a Manager resource in your account storage to manage all your scheduled transactions in one place. This is required before you can schedule transactions.

    flow schedule setup --signer my-account --network mainnet

    The Manager resource is stored at the standardized storage path and provides a consistent interface across all tools and explorers.

  • List Transactions

    View all scheduled transactions associated with an account, including their IDs, status, and scheduled execution time.

    flow schedule list <account> --network mainnet
  • Get Transaction Details

    Fetch complete details for a specific scheduled transaction by ID, including the transaction payload, execution window, and current status.

    flow schedule get <transaction-id> --network mainnet
  • Cancel Transactions

    Cancel a pending scheduled transaction before it executes and receive a partial fee refund. This provides flexibility to adjust or remove scheduled operations.

    flow schedule cancel <transaction-id> --signer my-account --network mainnet

🏗️ Under the Hood

These commands rely on two key contracts:

  • FlowTransactionScheduler - System contract handling transaction scheduling and execution
  • FlowTransactionSchedulerUtils - Helper contract providing the Manager resource and discovery utilities

The Manager resource provides a standardized interface for managing and discovering scheduled transactions, ensuring consistency across wallets, explorers, and development tools.

💡 Pro Tip

Combine Scheduled Transactions with Flow Agents and Flow Actions to create user-owned, autonomous financial strategies that execute trustlessly on-chain—no off-chain bots or custodians required!

📘 Learn more: Scheduled Transactions Guide
🧰 CLI Documentation: Flow CLI Scheduled Transactions Commands
🎯 Forte Upgrade: Introducing Actions & Agents

(#2141, #2140, #2133, #2132, #2130) @chasefleming


DeFi Actions Project Starter in flow init

You can now bootstrap a DeFi Actions project directly from the flow init wizard. This starter provides a complete, working example for building composable DeFi connectors—the building blocks that power autonomous agents and user-owned financial workflows on Flow.

image

What's included:

  • TokenSink connector implementing the DeFiActions.Sink interface
  • Pre-configured dependencies (DeFiActions, DeFiActionsUtils, DeFiActionsMathUtils)
  • Working tests using the Flow Testing Framework
  • Example transaction demonstrating token deposits via the connector
  • Comprehensive README with Quick Start guide

Example:

flow init
# Select: "DeFi Actions project (build composable DeFi connectors)"
flow test  # Everything works out of the box

📘 Learn more: Flow Actions FLIP #339 | Flow Actions Docs | Repository

(#2143) @jribbink

🛠 Improvements

Mainnet Forte upgrade compatibility updates

Updated all core dependencies to support the mainnet Forte network upgrade:

Flow Core Dependencies:

  • onflow/cadencev1.8.1 - Cadence language runtime with Forte features
  • onflow/flow-go-sdkv1.9.0 - Flow Go SDK with updated transaction types
  • onflow/flow-gov0.43.3 - Core Flow protocol implementation
  • onflow/flow-emulatorv1.9.0 - Local development emulator
  • onflow/flowkit/v2v2.7.0 - Flow development toolkit

Cadence Tools:

  • onflow/cadence-tools/testv1.7.0 - Testing framework with Forte support
  • onflow/cadence-tools/lintv1.6.0 - Cadence linter
  • onflow/cadence-tools/languageserverv1.7.0 - LSP for Cadence IDE support

Additional Dependencies:

  • onflow/flixkit-go/v2v2.6.0 - FLIX template support
  • onflow/flow-evm-gatewayv1.3.5 - EVM gateway with bridge improvements
  • github.com/getsentry/sentry-gov0.36.1 - Error tracking
  • golang.org/x/termv0.36.0 - Terminal utilities
  • google.golang.org/grpcv1.76.0 - gRPC communication

These updates ensure full compatibility with the mainnet Forte network upgrade and enable support for Flow Actions, Scheduled Transactions, and Flow Agents.

(#2146) @jribbink
(#2137) @dependabot
(#2126) @dependabot
(#2123) @dependabot

v2.8.3

Choose a tag to compare

@jribbink jribbink released this 10 Oct 18:43
d8c8092

⬆️ Install or Upgrade

Follow the Flow CLI installation guide for instructions on how to install or upgrade the CLI.

Full Changelog: v2.8.2...v2.8.3

v2.8.2

Choose a tag to compare

@github-actions github-actions released this 10 Oct 15:31
ded1d34

⬆️ Install or Upgrade

Follow the Flow CLI installation guide for instructions on how to install or upgrade the CLI.

Full Changelog: v2.8.1...v2.8.2

v2.8.1

Choose a tag to compare

@github-actions github-actions released this 09 Oct 21:20
e667679

⬆️ Install or Upgrade

Follow the Flow CLI installation guide for instructions on how to install or upgrade the CLI.

⭐ Features

Stablecoin scaffold in flow init

You can now bootstrap a Stablecoin project directly from the flow init wizard. The scaffold is based on the community template and comes pre-wired for a fast start.
Source: https://github.com/onflow/stablecoin-scaffold

Example:

flow init
# then select: "Stablecoin scaffold"

Reduces confusion during redeploys by prompting users to pass --update if a contract already exists.
(#2116) @chasefleming

🛠 Improvements

Deploy hint: suggest --update when contract exists

Reduces confusion during redeploys by prompting users to pass --update if a contract already exists.
(#2111) @jribbink

Dependency updates

  • onflow/cadencev1.7.1
  • onflow/flow-go-sdkv1.8.4
  • onflow/flow-goc6967df18fa9
  • onflow/flow-emulatorv1.8.0
  • onflow/cadence-tools/testv1.6.0
  • onflow/cadence-tools/lintv1.4.1
  • onflow/cadence-tools/languageserverv1.6.1
  • onflow/flixkit-go/v2v2.5.1
  • onflow/flowkit/v2v2.6.1
  • onflow/flow-evm-gatewaycae1289

(#2117)

🐞 Bug Fixes

Resolves an issue where emulator VM bridge setup events were not indexed by the EVM gateway.

v2.8.0

Choose a tag to compare

@jribbink jribbink released this 01 Oct 00:18
a33d3c6

⬆️ Install or Upgrade

Follow the Flow CLI installation guide for instructions on how to install or upgrade the CLI.

⭐ Features

Scheduled Transactions starter project in flow init

You can now bootstrap a project preconfigured for Scheduled Transactions directly from the flow init wizard.

Screenshot 2025-09-23 at 5 09 57 PM

Example:

flow init
# then select: "Scheduled Transactions" starter

(#2091) @chasefleming

Fund emulator accounts with flow accounts fund

flow accounts fund now supports funding emulator accounts, making local testing faster.

Example:

flow accounts fund service

(#2099) @chasefleming

🛠 Improvements

Language Server: Automatic flow.json management & concurrent projects

Cadence Language Server updated to v1.6.0. The LS now natively detects the project root per open file, infers the nearest ancestor flow.json, supports multiple open projects at once, and prompts to create a project if none exists. Backward-compatible: specifying an explicit flow.json path in init options still works.

(#2109) @jribbink

Mix testnet & mainnet dependency sources

Dependency installation now allows mixing sources across networks when appropriate.
(#2105) @chasefleming

Prompt flow: show tree before prompting

Improves UX by displaying the project tree before interactive prompts in init/install flows.
(#2108) @chasefleming - (#2096) @chasefleming

Other improvements

Test maintenance: fix handler tests.
(#2107) @chasefleming

Dependency updates

github.com/onflow/flow-evm-gateway1.3.3.
(#2104) @dependabot

🐞 Bug Fixes

No user-facing bug fixes in this release.

v2.7.3

Choose a tag to compare

@jribbink jribbink released this 26 Sep 02:23
673909f

What's Changed

Full Changelog: v2.7.2...v2.7.3

v2.7.2

Choose a tag to compare

@github-actions github-actions released this 25 Sep 05:32
7976228

⬆️ Install or Upgrade

Follow the Flow CLI installation guide for instructions on how to install or upgrade the CLI.

🛠 Improvements

v2.7.2-preview

v2.7.2-preview Pre-release
Pre-release

Choose a tag to compare

@jribbink jribbink released this 25 Sep 03:32

Preiew release with latest scheduled tx

v2.7.1

Choose a tag to compare

@github-actions github-actions released this 23 Sep 19:15
8ee31d0

⬆️ Install or Upgrade

Follow the Flow CLI installation guide for instructions on how to install or upgrade the CLI.

⭐ Features

Deployment account flag for dependency installation (#2074) @chasefleming

The flow dependencies install command now supports a --deployment-account (or shorthand -d) flag.
This feature skips the usual interactive deployment prompts and automatically installs dependencies into the specified deployment account.

Example:

flow dependencies install ExampleContract --deployment-account emulator-account

or using shorthand:

flow dependencies install ExampleContract -d emulator-account

🛠 Improvements

v2.7.0

Choose a tag to compare

@github-actions github-actions released this 20 Sep 00:36
b49261c

⬆️ Install or Upgrade

Follow the Flow CLI installation guide for instructions on how to install or upgrade the CLI. Flow Developer Portal

⭐ Features

Query a system transaction (optionally by ID)

You can now retrieve the system transaction for any block, with optional filtering by transaction ID—part of the upcoming Forte upgrade.

Syntax

flow transactions get-system <block_id|latest|block_height> [tx-id]

Examples

# Get the system transaction for the latest block
flow transactions get-system latest

# Get the system transaction for the latest block, filtered by a specific tx ID
flow transactions get-system latest 07a8...b433

(#2077) @jribbink GitHub


(#2077) @jribbink GitHub

List accounts with validity, network & balance

A new command shows the configured accounts along with whether they're valid, which network they target, and their current balance.

Example:

flow accounts list

(#2082) @chasefleming GitHub

🛠 Improvements

Dark terminal readability

Updated to a brighter default font color to improve readability in dark terminals.

(#2078) @chasefleming GitHub

Input prompt polish

Fixed a cutoff placeholder on the project-name text-input prompt.

(#2079) @chasefleming GitHub

Funding tip

Added a helpful tip to guide users on funding accounts.

(#2083) @chasefleming GitHub

🐞 Bug Fixes

No new user-facing bug fixes in this release.


Full Changelog: v2.6.1...v2.7.0