Code Deck for VS Code

Code Deck provides a persistent, Stream Deck-like grid interface within VS Code to launch commands, scripts, and open files with a single click.

Features

• Grid Layout: Customizable grid of tiles (default 5x3).
• Multiple Pages: Organize tiles across multiple pages.
• Drag & Drop: Easily rearrange tiles by dragging them.
• Shortcuts: Quickly trigger tiles using keyboard shortcuts.
• Validation: "Repair Config" command to fix duplicate or corrupted settings.

Tile Types

• Command: Execute any VS Code command (e.g., workbench.action.toggleSidebarVisibility).
• Terminal: Run shell commands in the integrated terminal (e.g., npm run build, echo "Hello").
• File: Open a specific file in the editor.
• Toggle: Create toggle switches that maintain state (On/Off) and can watch VS Code configuration settings.

Configuration

Configuration is stored in dedicated JSON files:

• User tiles: ~/.codedeck/config.json
• Workspace tiles: .codedeck.json (in project root)

{
  "tiles": [],
  "grid": {
    "columns": 5,
    "rows": 3
  }
}

Shortcuts

• Alt + 1 to Alt + 9: Execute tiles 1-9 on the current page.
• Alt + 0: Execute tile 10.
• Ctrl + Alt + Left Arrow: Go to previous page.
• Ctrl + Alt + Right Arrow: Go to next page.

Troubleshooting

Settings Corruption

If you encounter issues where tiles are duplicated or state changes are not reflected, run the repair command:

1. Open Command Palette (Cmd+Shift+P / Ctrl+Shift+P)
2. Run Code Deck: Repair Config
3. This will remove duplicate entries and fix IDs in your config files.

Usage

1. Open the panel via the command Code Deck: Open.
2. Right-click an empty slot to Add a tile.
3. Right-click an existing tile to Edit or Remove it.
4. Drag and drop to reorder.