VSForces

VSForces bridges Codeforces with VS Code — giving you a full competitive programming workflow without leaving your editor.

• 🔍 Browse and fetch random problems by rating, contest year, and tags
• 📄 Read the full problem statement (with LaTeX math) in the VS Code sidebar
• ⚡ Test cases auto-load into CPH Judge in your currently open file — no new file created, no language prompt
• 🚀 Submit your solution to Codeforces directly from VS Code
• 🏆 Track submission verdicts in real time
• ⏱️ Built-in per-problem stopwatch
• 🔥 Daily solve streak tracker

How It Works

VSForces is made of two parts that work together:

Codeforces Page
      │  (content script scrapes problem)
      ▼
Chrome Extension  ──────────────────────┐
      │  WebSocket  ws://127.0.0.1:6543  │
      ▼                                  │
VS Code Extension ◄─────────────────────┘
      ├── Sidebar (problem statement + timer)
      └── Writes .prob file → CPH Judge auto-detects

You need both installed for VSForces to work.

Requirements

Node.js is NOT required — you are installing a pre-built extension, not building from source.

Installation

Step 1 — Install the VS Code Extension

1. Open VS Code
2. Go to the Extensions view (Ctrl+Shift+X)
3. Search for VSForces
4. Click Install

Step 2 — Install CPH Judge

1. Open VS Code → Extensions view (Ctrl+Shift+X)
2. Search for Competitive Programming Helper
3. Install the extension by DivyanshuAgrawal

Step 3 — Install the Chrome Extension

1. Open the VSForces Bridge page on the Chrome Web Store
2. Click Add to Chrome
3. Confirm the permissions prompt

💡 Using Edge? The Chrome Web Store works in Edge too — or search for VSForces Bridge in the Edge Add-ons store.

💡 Pin the extension to your toolbar for easy access.

Step 4 — Set CPH Default Language (Recommended)

To prevent CPH from prompting for a language every time:

1. Open VS Code Settings (Ctrl+,)
2. Search for cph.general.defaultLanguage
3. Set it to your preferred language: cpp, java, python, etc.

Usage

Before You Start

Open your solution file in VS Code (Main.java, solution.cpp, etc.) before browsing to a problem. CPH loads test cases into whichever file is currently active.

Fetch a Random Problem

1. Click the VSForces icon in the VS Code Activity Bar (left sidebar)
2. Set Min / Max rating and optionally adjust the contest year slider and tag filters
3. Click Get random problem
4. The problem opens in Chrome and the statement appears in the sidebar with test cases loaded in CPH automatically

Browse to Any Problem Manually

Navigate to any Codeforces problem page in Chrome — the sidebar and CPH update automatically.

Submit & Track Verdict

Click the Submit button in the sidebar to submit your currently open file directly to Codeforces. The verdict appears in the sidebar once judging completes.

Timer

A stopwatch starts automatically when a new problem loads. You can pause, resume, or reset it manually. It stops automatically on Accepted.

Problem Navigation

VSForces keeps your last 4 problems in a navigation queue. Use the ← → buttons above the problem title to jump back to a previous problem (test cases re-sync with CPH automatically).

Features

Troubleshooting

License

Proprietary — All rights reserved. See the LICENSE file for details.