Projecto Terminal Tools is the VS Code-compatible companion for Projecto Desktop. It keeps terminal execution visible inside the editor and connects to the desktop app through a localhost-only bridge.
It works with editors that support the VS Code extension API, including:
- Visual Studio Code
- Cursor
- VSCodium
- Windsurf and similar VS Code-based editors
Features
- Open or reveal a reusable
Projecto Terminal
- Open a terminal directly in the editor area
- Create a fresh workspace terminal
- Split the active terminal
- Pick an already open terminal
- Send the current selection or active line to the terminal
- Run a custom command from an input prompt
- Use a status bar shortcut for quick terminal access
- Connect to Projecto Desktop
- Register the current workspace with Projecto
- Run Projecto launch profiles and saved commands through the desktop bridge
- Receive editor-terminal commands from Projecto Desktop and run them with the VS Code terminal API
Commands
Open the command palette and run any of these:
Projecto: Terminal Quick MenuProjecto: Connect to DesktopProjecto: Register Current WorkspaceProjecto: Run Launch ProfileProjecto: Run Saved CommandProjecto: Show Connection StatusProjecto: Open or Reveal TerminalProjecto: New Workspace TerminalProjecto: Open Terminal in Editor AreaProjecto: Split Active TerminalProjecto: Pick Existing TerminalProjecto: Send Selection or Line to TerminalProjecto: Run Command in Terminal
Development
- Open this folder in a VS Code-compatible editor.
- Press
F5 to launch an Extension Development Host.
- In the new window, open the command palette and run
Projecto: Terminal Quick Menu.
Packaging
To package the extension as a .vsix, install the VS Code packaging tool and run:
npm install -g @vscode/vsce
vsce package
Notes
This extension can control terminals exposed through the VS Code extension API. A single extension cannot directly control every non-VS Code editor family such as JetBrains, Sublime Text, or Notepad++ because those editors use different extension systems.
The extension does not process billing, Firebase auth, or Dodo payments. Projecto Web remains the source of truth for auth, subscriptions, desktop sessions, and project metadata.
Bridge details live in docs/desktop-bridge.md.
