Overlay Terminal for VS Code

A tiny VS Code extension that opens a terminal in a new window using any of your configured terminal profiles. When the shell exits the window closes and focus returns to the editor (sending Esc for VSCodeVim users).

Install

From the latest release

1. ⬇️ Download the latest .vsix.
2. Install it:

   code --install-extension ./overlay-terminal.vsix
   

From source

npm install --ignore-scripts
npm run build
npm run package
# overlay-terminal.vsix will appear in the repo root

Usage

• Command Palette: Overlay Terminal: Pick Profile.
• Open a specific profile with a keybinding:

  {
    "key": "ctrl+`",
    "command": "overlayTerminals.openProfile",
    "args": { "profileName": "zsh" }
  }
  

The extension uses your OS specific terminal.integrated.profiles.* setting and moves the terminal into a separate window with workbench.action.terminal.moveIntoNewWindow.

CI / Releases

• Every push to main builds the extension and uploads the packaged .vsix as a workflow artifact.
• Pushing a tag like vX.Y.Z also creates a GitHub release with the .vsix attached.

Commands

• overlayTerminals.openProfile – Overlay Terminal: Open Profile
• overlayTerminals.pickProfile – Overlay Terminal: Pick Profile