Terminal Restore

Automatically create named terminal tabs when you open a workspace in VS Code or Cursor. Configure per-project via settings or a dedicated config file.

Features

• Auto-restore terminals on workspace open
• Named tabs for each terminal
• Startup commands — run a command when a terminal is created
• Icons and colors — customize terminal tabs with codicons and theme colors
• Shell-ready detection — waits for the shell to fully initialize before running commands (uses shell integration with processId fallback)
• Per-project config via .terminal-restore.json (takes priority over settings)
• Commands to manually create or close all managed terminals

Configuration

Option 1: .terminal-restore.json (recommended)

Create a .terminal-restore.json file in your workspace root:

{
  "terminals": [
    { "name": "dev", "command": "npm run dev", "icon": "play", "color": "terminal.ansiGreen" },
    { "name": "tests", "command": "npm test -- --watch", "icon": "beaker" },
    { "name": "deploy", "icon": "rocket", "color": "terminal.ansiRed" },
    { "name": "git", "icon": "git-merge", "color": "terminal.ansiMagenta" },
    { "name": "shell" }
  ]
}

Option 2: VS Code Settings

Add to your settings.json (workspace or user):

{
  "terminalRestore.terminals": [
    { "name": "dev", "command": "npm run dev", "icon": "play", "color": "terminal.ansiGreen" },
    { "name": "shell" }
  ],
  "terminalRestore.autoRestore": true
}

If both exist, .terminal-restore.json takes priority.

Terminal Options

Settings

Commands

License

MIT