Skip to content

AudioLab VS Code Workspaces

Production-ready workspace configurations optimized for different development workflows.

📂 Available Workspaces

1. AudioLab-ClaudeGrid-8.code-workspace

Purpose: Mass parallel development with up to 8 Claude Code instances Layout: 8-panel grid (optimized for ultrawide or multi-monitor) Use When: - Running multiple Claude Code agents simultaneously - Parallel development across different modules - Large-scale refactoring with AI assistance

Key Settings: - No editor limits (50 tabs max) - Multi-instance Claude Code support - Prevents unwanted tab closures - Disables preview mode

2. AudioLab-ClaudeGrid-4.code-workspace

Purpose: Balanced parallel workflow (2x2 grid) Layout: 4-panel grid Use When: - Working on 4 related components simultaneously - Comparing implementations across modules - Moderate parallel development

Key Settings: - Horizontal split optimization - 40 tab limit - Multi-instance Claude Code support - Empty groups persist

3. AudioLab-Single.code-workspace

Purpose: Deep focus single-editor workflow Layout: Single maximized editor with sidebar Use When: - Deep focus on single component - Writing complex algorithms - Debugging single module - Learning new codebase areas

Key Settings: - Preview mode enabled - 10 tab limit (focused) - Single Claude Code instance - Minimap and breadcrumbs enabled - Welcome page on startup

4. AudioLab-Review.code-workspace

Purpose: Side-by-side code review and comparison Layout: 50/50 vertical split Use When: - Code reviews - Before/after comparisons - API contract verification - Diff analysis

Key Settings: - Vertical split optimization - Side-by-side diff rendering - GitLens recommended - 20 tab limit - Whitespace comparison enabled

🚀 How to Use

Opening a Workspace

  1. Double-click the .code-workspace file in File Explorer
  2. OR in VS Code: File → Open Workspace from File...
  3. OR drag & drop onto VS Code icon

First-Time Setup

When you open a workspace for the first time: 1. VS Code will prompt to install recommended extensions 2. Click "Install All" for optimal experience 3. Restart VS Code if prompted

Switching Workspaces

  • File → Close Workspace (closes current)
  • Open new workspace file
  • Recent workspaces appear in File → Open Recent

⚙️ Customization

Modifying Layouts

Each workspace's settings override your global VS Code settings. To customize:

  1. Open workspace file in editor
  2. Modify settings section
  3. Save and reload workspace

Common Customizations

Change editor tab limit: 

"workbench.editor.limit.value": 30

Adjust split direction: 

"workbench.editor.splitInGroupLayout": "horizontal" // or "vertical"

Toggle sidebar visibility: 

"workbench.sideBar.location": "right" // or "left"

🛠️ AudioLab-Specific Settings

All workspaces include:

File Associations

"*.hpp": "cpp"
"*.ipp": "cpp"
"CMakeLists.txt": "cmake"

C++ Integration

"C_Cpp.default.configurationProvider": "ms-vscode.cmake-tools"
"cmake.configureOnOpen": false  // Prevents auto-configuration spam
  • saoudrizwan.claude-dev - Claude Code AI assistant
  • ms-vscode.cpptools - C/C++ IntelliSense
  • ms-vscode.cmake-tools - CMake integration
  • eamodio.gitlens - Git supercharged (Review workspace)

📊 Workflow Guide

Task Recommended Workspace
Building new feature across modules ClaudeGrid-8
Refactoring 4 related classes ClaudeGrid-4
Implementing single algorithm Single
PR review Review
Learning codebase Single
Parallel AI development ClaudeGrid-8
Debugging one component Single
Comparing old vs new API Review

🔧 Troubleshooting

Workspace Not Loading Correctly

  • Delete .vscode/workspace.json in project root
  • Reopen workspace file
  • VS Code will regenerate settings

Tabs Keep Getting Replaced

  • Check workbench.editor.enablePreview is false
  • Verify workspace settings are active (check bottom-right status bar)

Claude Code Not Multi-Instance

  • Ensure claude.multiInstance: true in workspace
  • Restart VS Code
  • Check extension settings override workspace

Layout Resets on Restart

  • Verify window.restoreWindows: "all"
  • Save workspace layout before closing
  • Check Windows doesn't have session restore disabled

📝 Best Practices

  1. Name Your Windows: Use Window: Set Window Title command to distinguish multiple instances
  2. Save Layouts: Use Workspaces: Save Workspace As... to preserve custom layouts
  3. Git Ignore: Don't commit .vscode/workspace.json (user-specific state)
  4. Multiple Monitors: ClaudeGrid-8 works best on 32"+ ultrawide or dual monitors
  5. Performance: Close unused editor groups to reduce memory usage

🎯 Quick Start

New to AudioLab? Start with AudioLab-Single.code-workspace Experienced developer? Use AudioLab-ClaudeGrid-4.code-workspace AI-powered workflow? Go straight to AudioLab-ClaudeGrid-8.code-workspace

Generated for AudioLab development environment Location: 2 - FOUNDATION/03_INFRA/03_00_development_environment/03_00_01_ide_configurations/vscode/workspaces/