IDE

Fring integrates with VS Code, Cursor, or any IDE that supports a terminal. Just run fring in the terminal to get started.

---

Usage

• Quick Launch: Use Cmd+Esc (Mac) or Ctrl+Esc (Windows/Linux) to open Fring in a split terminal view, or focus an existing terminal session if one is already running.
• New Session: Use Cmd+Shift+Esc (Mac) or Ctrl+Shift+Esc (Windows/Linux) to start a new Fring terminal session, even if one is already open. You can also click the Fring button in the UI.
• Context Awareness: Automatically share your current selection or tab with Fring.
• File Reference Shortcuts: Use Cmd+Option+K (Mac) or Alt+Ctrl+K (Linux/Windows) to insert file references. For example, @File#L37-42.

---

Which editors, and how

The download page advertises five editors, and they do not all install the same way. Pick the row that matches yours:

Editor	How Fring integrates
VS Code	The Fring extension — installs itself when you run fring in the integrated terminal
Cursor	Same extension, same automatic install
Windsurf	Same extension, same automatic install
VSCodium	Same extension, same automatic install
Zed	Not an extension. Zed is not a VS Code fork and has no Fring extension — it talks to Fring over ACP instead

Any other editor with a terminal works too, without an extension: run fring in it.

---

VS Code and its forks

To install Fring on VS Code and the forks that share its extension marketplace — Cursor, Windsurf, VSCodium:

1. Open the editor
2. Open the integrated terminal
3. Run fring — the extension installs automatically

If on the other hand you want to use your own IDE when you run /editor or /export from the TUI, you’ll need to set export EDITOR="code --wait". Learn more.

---

Manual Install

Search for Fring in the Extension Marketplace and click Install. The extension is published by Fring AI — its identifier is fring.fring. Check the publisher before installing: there are similarly named extensions from other projects.

Or from the command line — using your editor’s own CLI, not code, unless you are actually on VS Code:

# VS Code
code --install-extension fring.fring

# Cursor
cursor --install-extension fring.fring

# Windsurf
windsurf --install-extension fring.fring

# VSCodium
codium --install-extension fring.fring

If the command is not found, see Troubleshooting below — each editor installs its shell command separately.

---

Zed

Zed does not use the extension above. It is not a VS Code fork and does not share that marketplace, so there is nothing to install from it — Zed speaks the Agent Client Protocol instead, and Fring is registered as an agent server.

Add this to ~/.config/zed/settings.json:

~/.config/zed/settings.json

{
  "agent_servers": {
    "Fring": {
      "command": "fring",
      "args": ["acp"]
    }
  }
}

Then run agent: new thread from the Command Palette.

The ACP page covers the keybinding, the other ACP-capable editors, and what fring acp actually does.

---

Troubleshooting

If the extension fails to install automatically:

• Ensure you’re running fring in the integrated terminal.
• Confirm the CLI for your IDE is installed:
  • For VS Code: code command
  • For Cursor: cursor command
  • For Windsurf: windsurf command
  • For VSCodium: codium command
  • If not, run Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows/Linux) and search for “Shell Command: Install ‘code’ command in PATH” (or the equivalent for your IDE)
• Ensure VS Code has permission to install extensions