VS Code Shell Integration Zsh Plugin

August 1, 2025 ยท View on GitHub

A simple zsh plugin that automatically activates VS Code shell integration when working in VS Code terminals.

What it does

This plugin automatically loads VS Code's shell integration script when working in VS Code (stable or insiders) terminals, providing enhanced terminal features like command decorations, directory tracking, and better navigation.

Installation

Using Oh My Zsh

  1. Clone this repository into your Oh My Zsh custom plugins directory:

    git clone https://github.com/tolkonepiu/vscode-shell-integration-zsh-plugin.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/vscode-shell-integration

  2. Add the plugin to your ~/.zshrc file:

    plugins=(... vscode-shell-integration)

  3. Restart your terminal or reload your zsh configuration:

    source ~/.zshrc

Manual Installation

  1. Clone or download this repository
  2. Source the plugin file in your ~/.zshrc:
source /path/to/vscode-shell-integration.plugin.zsh

Using a Plugin Manager

Zinit

zinit load tolkonepiu/vscode-shell-integration-zsh-plugin

Antigen

antigen bundle tolkonepiu/vscode-shell-integration-zsh-plugin

Zplug

zplug "tolkonepiu/vscode-shell-integration-zsh-plugin"

Antidote

antidote bundle tolkonepiu/vscode-shell-integration-zsh-plugin

License

This repository is licensed under the MIT License.