The Flow Relay extension brings handoffs and insights into your editor. It works in VS Code, Cursor (VS Code Marketplace) and Antigravity (Open VSX). Like the MCP server, it is a client of the REST API.
- VS Code / Cursor – search "Flow Relay" in the Extensions panel, or install from the VS Code Marketplace.
- Antigravity – install from the Open VSX Registry.
- Manual – download the
.vsixfrom Downloads and run Extensions: Install from VSIX....
- Open the command palette (
Ctrl+Shift+P) and run Flow Relay: Set API Key. - Paste a key from Settings > API Keys. It is stored in the editor's secret storage.
- The Flow Relay sidebar appears – you are ready to go.
| Command | Description |
|---|---|
| Set API Key | Store your API key in secret storage. |
| Select Project Context | Switch between personal stream and accessible projects. |
| Generate Handoff | Generate a handoff from all connected sources. |
| Generate Handoff with Filters... | Scope sources and set per-source filters in a visual panel. |
| Show Handoffs | Browse and open recent handoffs. |
| Show Last Handoff | View the most recent active handoff. |
| Show Integrations | See connected integrations with workspace info. |
| List Discord Channels | List text channels in your connected server. |
| Send Discord Message | Post to a Discord channel – type a message, or send the latest handoff / correlation / onboarding / architecture / release-notes artifact for the active project as a .md attachment. |
| Generate Project Insight... | Generate a correlation, onboarding or architecture insight. |
| Generate Release Notes | Turn the active project's merged work into release notes, or a PR description – pick the style, then the repository to cover. |
| Generate Plan Review | Write a status report for the active project from the numbers of its plan and the last 14 days of linked activity, opened as Markdown. Costs 5 credits. |
| Show Earned Value | Read the costs of the active project against its baseline – planned and actual cost, earned value, SPI, CPI and the estimate at completion. Project managers, on plans that include costs. |
| Show Risk Register | List the open risks, issues, decisions and dependencies of the active project with their score, due date and linked item. |
| Show Forecast | Simulate the active project's plan (or its recent pace) and list the dates by which half, four out of five and nineteen out of twenty of the runs are done, with the chance of the target and each milestone's likely date. Business plan and above. |
| Create Work Item from Selection | Turn the selected text of the editor into an item of the active project, with the file and line it came from in its description. |
| Ask a What-if Question | Try a what-if question on a copy of the active project's plan and see the new finish dates. Costs 5 credits and changes nothing. Business plan and above. |
| Add a Template to the Plan | Pick a saved template and add it to the active project, at the top level or under an item key. Project managers only. |
| Show Change Requests | List the change requests of the active project: what was asked, who asked, who decided and what they said. |
| Decide a Change Request | Approve, reject or withdraw a change request that waits for a decision, with an optional note. You cannot decide a request you made, and only its author can withdraw it. |
| Accept or Dismiss a Suggestion | List the pending suggestions of the active project (status changes, new items, dependencies and evidence proposed from linked activity) and accept or dismiss one. |
| Add a Register Entry | Add a risk, assumption, issue, decision or dependency to the register of the active project. |
| Delete a Work Item | Delete an item and everything under it after a confirmation. A project manager can restore it from the change history. |
| Request a Change to an Item | Ask for a change to an item (status, progress, duration or deadline) that a second person must approve. Files the request and changes nothing until it is approved. |
| Show Portfolio | List the projects of an organization you can open with their progress, forecast finish, next milestone, open risks and health. Business plan and above. |
| Ask This Project | Ask one question about the active project and read the answer as a Markdown document. |
| Show Insights | Browse recent project insights. |
| Show Digests | Browse the active project's scheduled digests and open one as Markdown. |
| Show Events | Browse recent events in the active scope. |
| Show Untracked Resources | List active resources not yet assigned to a project. |
| Show My Work | Pick one of the work items assigned to you across every project, then start it, change its status or open it. |
| Start Work Item | Create and check out a branch named after an item (fr-12-refund-flow) and move it to In progress. Commits and pull requests on that branch link to the item. |
| Change Work Item Status... | Move one of your items to another status. |
| Show Current Branch Work Item | Show the item named by the checked-out branch, change its status or open it in Flow Relay. |
| Refresh | Refresh all sidebar panels. |
Four sidebar panels mirror your workspace: Workspace context (account mode, role, active scope), My Work (the items assigned to you, with start and status actions), Handoffs (the active scope's handoffs) and Integrations (resource health and provider coverage). A status-bar button shows the active scope and lets you generate a handoff in one click. When the checked-out branch names an item key (fr-12-refund-flow, feature/FR-12), a second status-bar entry shows that item and its status – see Work management.
The filter panel for handoffs and insights uses the same real, selectable values returned by the filters endpoint – see Filters.