pi-ide-bridge

IDE bridge extension for Pi: VS Code / Cursor / Trae context, file inserts, and heartbeat support.

Packages

Package details

extension

Install pi-ide-bridge from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-ide-bridge
Package
pi-ide-bridge
Version
0.4.4
Published
Jun 22, 2026
Downloads
743/mo · 44/wk
Author
zuoling003
License
MIT
Types
extension
Size
36.8 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

Pi IDE Bridge

Pi extension that bridges your IDE (VS Code, Cursor, Trae) with the Pi coding agent.

Features

  • Live IDE context: active file, workspace roots, open files, and current selection.
  • Multi-root workspace support.
  • Automatic connection state: shows VS Code: connected / Cursor: connected / Trae: connected and falls back to not connected when the IDE closes.
  • Heartbeats via /ide-ping for accurate disconnect detection.
  • File/terminal inserts from the IDE into Pi's input editor.
  • Enhanced @ autocompletion with open IDE files.
  • One-click companion install via /ide init.
  • Slash commands:
    • /ide init — install the VS Code / Cursor / Trae companion extension
    • /ide-state
    • /ide-bridge-port
    • /ide-insert-active-file
    • /ide-insert-selection
    • /ide-open-files
    • /ide-clear-selection
  • Keyboard shortcuts:
    • Ctrl+Shift+A / Cmd+Shift+A: insert active file
    • Ctrl+Shift+S / Cmd+Shift+S: insert current selection

Install

pi install npm:pi-ide-bridge

Or install from git:

pi install git:github.com/Wuhu-dsm/pi-ide-bridge@v0.4.0

Then reload Pi:

/reload

Install the companion IDE extension

After the Pi extension is loaded, run:

/ide init

Pi will detect any VS Code / Cursor / Trae CLI on your PATH, download the latest companion .vsix from GitHub, and install it automatically. If the editor CLI is not on PATH, install it manually (see below).

Update

pi update npm:pi-ide-bridge
/reload

Uninstall

pi remove npm:pi-ide-bridge
/reload

Companion IDE Extension

The companion extension for VS Code / Cursor / Trae is available as a .vsix from the GitHub releases:

# VS Code
code --install-extension pi-ide-bridge-vscode-0.4.0.vsix

# Cursor
cursor --install-extension pi-ide-bridge-vscode-0.4.0.vsix

# Trae
trae --install-extension pi-ide-bridge-vscode-0.4.0.vsix

Or open the Extensions view, click ... → Install from VSIX.

License

MIT