TerminalGrid

Transform VS Code into a powerful terminal workspace with keyboard-driven grid management and optional auto-launch for CLI tools.

Features

🎹 Keyboard-Driven Grid Management: Create complex terminal layouts with simple shortcuts
🚀 Optional Auto-Launch: Run any command in every new terminal (AI tools, dev servers, etc.)
🖼️ Image Support: Paste screenshots directly into terminals (unlike native terminal grids)
💾 Persistent Sessions: Your terminal sessions persist across VS Code restarts
⚙️ Simple Configuration: One setting to rule them all

Why TerminalGrid?

VS Code's integrated terminal only supports horizontal splitting (side-by-side). There's no native way to stack terminals vertically or create complex grids. This has been requested for years in VS Code issues #56112, #160501, and #162710, but hasn't been implemented.

TerminalGrid solves this by moving terminals to the editor area, where you get full horizontal and vertical split control.

Additionally, image pasting in native terminals is unreliable for Claude Code and other AI tools (see issues #1361, #5392, #834). VS Code's terminal integration provides much better support for pasting screenshots and dragging files.

For AI-driven coding: Run multiple concurrent AI coding sessions in a clean grid layout. Paste screenshots reliably for visual debugging. Manage everything from one workspace instead of scattered terminal windows.

For regular development: Keyboard-driven terminal management is useful even without auto-launch. Quickly create complex grid layouts for dev servers, test runners, log monitoring, and interactive shells.

Keyboard Shortcuts

Shortcut	Action
`Cmd+K Cmd+Down` (Mac) `Ctrl+K Ctrl+Down` (Win/Linux)	Split down and open terminal
`Cmd+K Cmd+Right` (Mac) `Ctrl+K Ctrl+Right` (Win/Linux)	Split right and open terminal
`Cmd+K Cmd+N` (Mac) `Ctrl+K Ctrl+N` (Win/Linux)	Open new terminal
`Cmd+1/2/3/4` (Mac) `Ctrl+1/2/3/4` (Win/Linux)	Jump to specific terminal pane

Installation

VS Code Marketplace (recommended):

Open VS Code
Go to Extensions (Cmd+Shift+X / Ctrl+Shift+X)
Search for "TerminalGrid"
Click Install

Or install via command line:

code --install-extension MaxGhenis.terminalgrid

Manual Installation:

Download the .vsix from GitHub Releases, then:

In VS Code: Extensions → ... menu → "Install from VSIX..."

Configuration

`terminalgrid.autoLaunchCommand`

Command to run when opening a new terminal. Leave empty for plain terminals.

Examples:

{
  "terminalgrid.autoLaunchCommand": "claude --dangerously-skip-permissions"
}

{
  "terminalgrid.autoLaunchCommand": "aider --auto-commits"
}

{
  "terminalgrid.autoLaunchCommand": "codex"
}

{
  "terminalgrid.autoLaunchCommand": "gh copilot"
}

Popular AI Coding CLI Tools:

Claude Code - claude (Anthropic)
Codex CLI - codex (OpenAI)
Gemini CLI - gemini (Google, free)
GitHub Copilot CLI - gh copilot (GitHub/Microsoft)
Aider - aider (open source)
OpenHands - openhands (open source)

Other Settings

terminalgrid.enableTerminalsInEditor Open terminals in editor area for full grid control (default: true)

terminalgrid.enablePersistentSessions Restore terminal sessions across restarts (default: true)

terminalgrid.autoConfigureOnInstall Auto-configure settings on first install (default: true)

Quick Setup

Open Settings (Cmd+, / Ctrl+,)
Search for "TerminalGrid"
Set Auto Launch Command to your preferred tool (or leave empty)
Done! Use the keyboard shortcuts to build your grid

Example Workflow: Claude Code Superterminal

┌─────────────────┬─────────────────┐
│  Claude Code    │  Claude Code    │
│  (Policy work)  │  (PR review)    │
├─────────────────┼─────────────────┤
│  Claude Code    │  Claude Code    │
│  (Grant draft)  │  (Email/admin)  │
└─────────────────┴─────────────────┘

Setup:

{
  "terminalgrid.autoLaunchCommand": "claude --dangerously-skip-permissions"
}

Usage:

Cmd+K Cmd+Right → Claude Code starts in right pane
Cmd+K Cmd+Down in left pane → Claude Code starts below
Cmd+K Cmd+Down in right pane → Claude Code starts below
2x2 grid of Claude Code sessions ready!

Example Workflow: Development (No Auto-Launch)

┌─────────────────┬─────────────────┐
│  npm run dev    │  git status     │
├─────────────────┼─────────────────┤
│  pytest         │  python shell   │
└─────────────────┴─────────────────┘

Setup:

{
  "terminalgrid.autoLaunchCommand": ""
}

Use Cmd+K Cmd+Down/Right/N to quickly create your grid!

Requirements

VS Code 1.80.0 or higher
Optional: CLI tools you want to auto-launch

What It Configures

TerminalGrid automatically sets up:

Terminal Location: Moves terminals to editor area for full split control
Terminal Profile: Creates profile with your auto-launch command
Persistent Sessions: Enables session persistence across restarts
Keyboard Shortcuts: Adds grid management shortcuts

Known Issues

Windows shell initialization may vary by configuration
If using --dangerously-skip-permissions with Claude Code, ensure you trust your workspace

Contributing

Found a bug or have a feature request? Open an issue on GitHub.

Credits

Created by Max Ghenis.

Inspired by a workflow developed while leading PolicyEngine, where we use AI to model tax and benefit policies.

Read the blog post: Turning VS Code into a Claude Code Superterminal (coming soon)

License

MIT