Releases: onflow/flow-cli
Release list
v2.9.0
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
Managerresource 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.
What's included:
TokenSinkconnector implementing theDeFiActions.Sinkinterface- 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
🛠 Improvements
Mainnet Forte upgrade compatibility updates
Updated all core dependencies to support the mainnet Forte network upgrade:
Flow Core Dependencies:
onflow/cadence→ v1.8.1 - Cadence language runtime with Forte featuresonflow/flow-go-sdk→ v1.9.0 - Flow Go SDK with updated transaction typesonflow/flow-go→ v0.43.3 - Core Flow protocol implementationonflow/flow-emulator→ v1.9.0 - Local development emulatoronflow/flowkit/v2→ v2.7.0 - Flow development toolkit
Cadence Tools:
onflow/cadence-tools/test→ v1.7.0 - Testing framework with Forte supportonflow/cadence-tools/lint→ v1.6.0 - Cadence linteronflow/cadence-tools/languageserver→ v1.7.0 - LSP for Cadence IDE support
Additional Dependencies:
onflow/flixkit-go/v2→ v2.6.0 - FLIX template supportonflow/flow-evm-gateway→ v1.3.5 - EVM gateway with bridge improvementsgithub.com/getsentry/sentry-go→ v0.36.1 - Error trackinggolang.org/x/term→ v0.36.0 - Terminal utilitiesgoogle.golang.org/grpc→ v1.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
⬆️ Install or Upgrade
Follow the Flow CLI installation guide for instructions on how to install or upgrade the CLI.
- Add preview network for EVM gateway (#2121) @nialexsan
Full Changelog: v2.8.2...v2.8.3
v2.8.2
⬆️ 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
⬆️ 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/cadence→ v1.7.1onflow/flow-go-sdk→ v1.8.4onflow/flow-go→ c6967df18fa9onflow/flow-emulator→ v1.8.0onflow/cadence-tools/test→ v1.6.0onflow/cadence-tools/lint→ v1.4.1onflow/cadence-tools/languageserver→ v1.6.1onflow/flixkit-go/v2→ v2.5.1onflow/flowkit/v2→ v2.6.1onflow/flow-evm-gateway→ cae1289
(#2117)
🐞 Bug Fixes
Resolves an issue where emulator VM bridge setup events were not indexed by the EVM gateway.
v2.8.0
⬆️ 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.
Example:
flow init
# then select: "Scheduled Transactions" starter
Fund emulator accounts with flow accounts fund
flow accounts fund now supports funding emulator accounts, making local testing faster.
Example:
flow accounts fund service
🛠 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.
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-gateway → 1.3.3.
(#2104) @dependabot
🐞 Bug Fixes
No user-facing bug fixes in this release.
v2.7.3
v2.7.2
⬆️ Install or Upgrade
Follow the Flow CLI installation guide for instructions on how to install or upgrade the CLI.
🛠 Improvements
- Add
txalias fortransactionssubcommand (#2092) @B9UU - Skip prompts on
flow dependencies installwith no args (#2090) @chasefleming - Update to latest version of Scheduled Transactions (#2094) @jribbink
- chore: remove duplicate package import (#2088) @juejinyuxitu
v2.7.2-preview
Preiew release with latest scheduled tx
v2.7.1
⬆️ 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-accountor using shorthand:
flow dependencies install ExampleContract -d emulator-account🛠 Improvements
- Update to latest version of scheduled callbacks (#2089) @jribbink
- Bump github.com/charmbracelet/bubbletea from 1.3.9 to 1.3.10 (#2084) @dependabot
v2.7.0
⬆️ 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
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
🛠 Improvements
Dark terminal readability
Updated to a brighter default font color to improve readability in dark terminals.
Input prompt polish
Fixed a cutoff placeholder on the project-name text-input prompt.
Funding tip
Added a helpful tip to guide users on funding accounts.
🐞 Bug Fixes
No new user-facing bug fixes in this release.
Full Changelog: v2.6.1...v2.7.0