Droid works great with any Integrated Development Environment (IDE) that has a terminal. Just run droid, and you’re ready to go. In addition, Droid provides dedicated integrations for popular IDEs, which provide features like interactive diff viewing, selection context sharing, and more. These integrations currently exist for:
  • Visual Studio Code (including popular forks like Cursor, Windsurf, and VSCodium)
  • JetBrains IDEs (including IntelliJ, PyCharm, Android Studio, WebStorm, PhpStorm and GoLand)

​
Features

  • Quick launch: Use keyboard shortcuts to open Droid directly from your editor, or click the Droid button in the UI
  • Diff viewing: Code changes can be displayed directly in the IDE diff viewer instead of the terminal
  • Selection context: The current selection/tab in the IDE is automatically shared with Droid
  • File reference shortcuts: Use keyboard shortcuts to insert file references
  • Diagnostic sharing: Diagnostic errors (lint, syntax, etc.) from the IDE are automatically shared with Droid as you work

​
Installation

​
VS Code

To install Droid on VS Code and popular forks like Cursor, Windsurf, and VSCodium:
  1. Open VS Code
  2. Open the integrated terminal
  3. Run droid - the extension will auto-install

​
JetBrains

To install Droid on JetBrains IDEs like IntelliJ, PyCharm, Android Studio, WebStorm, PhpStorm and GoLand, find and install the Factory Droid plugin from the marketplace and restart your IDE. The plugin may also be auto-installed when you run droid in the integrated terminal. The IDE must be restarted completely to take effect.

​
Usage

​
From your IDE

Run droid from your IDE’s integrated terminal, and all features will be active.

​
From external terminals

Use the /ide command in any external terminal to connect Droid to your IDE and activate all features. If you want Droid to have access to the same files as your IDE, start Droid from the same directory as your IDE project root.

​
Troubleshooting

​
VS Code extension not installing

  • Ensure you’re running Droid from VS Code’s integrated terminal
  • Ensure that the CLI corresponding to your IDE is installed:
    • For VS Code: code command should be available
    • For Cursor: cursor command should be available
    • For Windsurf: windsurf command should be available
    • For VSCodium: codium command should be available
    • If not installed, use 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)
  • Check that VS Code has permission to install extensions

​
JetBrains plugin not working

  • Ensure you’re running Droid from the project root directory
  • Check that the JetBrains plugin is enabled in the IDE settings
  • Completely restart the IDE. You may need to do this multiple times

​
ESC key configuration

If the ESC key doesn’t interrupt Droid operations in JetBrains terminals:
  1. Go to Settings → Tools → Terminal
  2. Either:
    • Uncheck “Move focus to the editor with Escape”, or
    • Click “Configure terminal keybindings” and delete the “Switch focus to Editor” shortcut
  3. Apply the changes
This allows the ESC key to properly interrupt Droid operations.

​
Common issues

SymptomFix
”Editor integration disabled” messageVerify the extension/plug-in is installed and that editorIntegration matches your editor
CLI cannot find Node/BunEnsure the droid binary is on the PATH VS Code/JetBrains uses (restart after install)
Missing file contextSave files; unsaved buffers older than 500 KB are skipped for performance
Stale diagnosticsRun ↻ Refresh Diagnostics command (VS Code Command Palette)
VS Code terminal closes immediatelyCheck your shell’s startup scripts: they must not auto-exit
Network blocked in corporate proxyConfigure proxy variables in settings or set HTTP_PROXY/HTTPS_PROXY env vars
For additional help, email support@factory.ai with logs from ~/.factory/logs/

​
Next steps

Settings

Fine-tune thinking budget, tool permissions, and more.

Specification Mode

See how editor context improves feature delivery.