VS Code Web provides a browser-based code editing experience. Open task workspaces and project repositories directly in your browser without leaving Private AI.
VS Code Web is a lightweight version of Visual Studio Code that runs entirely in your browser, with syntax highlighting, IntelliSense, and extension support.

​
For Users

​
Opening VS Code Web

There are two ways to open VS Code Web, depending on what you want to work on:
Global Open in VS Code Web icon in project header
Local Open in VS Code Web button inside task workspace
Button LocationOpens
Project header (global icon)Entire project repository
Task detail (local icon)Specific task worktree

​
Opening a Task Worktree

Task worktrees contain the isolated git worktree where AI agents perform their work.
1

Navigate to a task

Go to any task with an active or completed attempt.
2

Click the local icon

In the task detail panel, click the Open in VS Code Web button inside the workspace section.
3

VS Code Web opens

A new browser tab opens with VS Code Web, loading the task’s worktree folder.

​
Opening the Project Repository

To browse the entire project repository:
1

Navigate to project

Go to the project page.
2

Click the global icon

Click the Open in VS Code Web icon in the project header (top of the page).
3

VS Code Web opens

A new browser tab opens with VS Code Web, loading the full project repository.
Use the global icon for general exploration, and the local icon for working on specific tasks.

​
For Administrators

​
Prerequisites

  • openvscode-server installed and configured
  • Network connectivity between Private AI and the VS Code server

​
Installing openvscode-server

Download and install openvscode-server from the official repository. Follow the installation instructions in their README.

​
Starting openvscode-server

Use PM2 to keep the server running persistently:
pm2 start "<path-to-openvscode-server>/bin/openvscode-server --port 3004 --connection-token YOUR_TOKEN --default-folder /var/tmp/vibe-kanban/worktrees --server-base-path /vscode" --name openvscode-server
Replace:
  • <path-to-openvscode-server> with your installation path
  • YOUR_TOKEN with a secure token
  • /var/tmp/vibe-kanban/worktrees with your worktrees directory path
Keep your connection token secure. Use a strong, randomly generated token in production.

​
Configuring Private AI

1

Open Settings

Navigate to Settings → Editor Config in the left sidebar.
2

Set VS Code URL

Enter your openvscode-server URL:
  • Production: https://your-domain.com/vscode
  • Development: http://localhost:<PORT> (use your custom port)
Editor Config settings page
3

Set Connection Token

Enter the same connection token used when starting openvscode-server.
4

Save

Click Save to store the settings.
Use the copy button next to each field to quickly copy configuration values.

​
Security Best Practices

  • Use a strong, randomly generated token (minimum 32 characters)
  • Rotate tokens regularly
  • Never commit tokens to version control
  • Always use HTTPS in production
  • Limit openvscode-server access to Private AI users only

​
Troubleshooting

  • Verify VS Code URL is correctly configured
  • Check connection token matches between Private AI and openvscode-server
  • Ensure openvscode-server is running and accessible
  • Verify connection token is set correctly in Editor Config
  • For production, ensure cookies are not blocked by the browser
  • Check openvscode-server was started with --connection-token flag
  • Verify the workspace exists
  • Check openvscode-server has access to the worktrees directory
  • Ensure VS Code URL and Connection Token are both configured
  • Refresh the page after saving configuration