Socratic

Socratic is an interactive development mentor built directly into the Visual Studio Code sidebar workspace. Designed to foster deep algorithmic thinking and logic retention, Socratic guides developers through complex programming bottlenecks using Socratic dialogue and active recall mechanics.

The Socratic Rule: This extension operates strictly as a teaching tool. It is intentionally restricted from writing code snippets, autofilling files, or providing direct solutions. Instead, it mirrors logic gaps back to the user to promote independent debugging, refactoring, and comprehensive code ownership.

Configuration (Bring Your Own Key)

To ensure privacy, keep usage free, and prevent shared quota exhaustion on the cloud backend, Socratic operates on a "Bring Your Own Key" model.

Generate a free API key from Google, ChatGPT, or any other LLM.

Open VS Code Settings (Ctrl+, or Cmd+,).

Search for Socratic.

Paste your key into the Socratic: API Key input field.

How to Use Socratic

Socratic integrates directly with your active coding workspace. Follow these exact steps to feed your code into the tutor and begin a guided learning session:

Step 1: Define Project Context

Click the Socratic icon in your VS Code Activity Bar (left sidebar). On the welcome screen, enter a brief description of your high-level project goal (e.g., Building an automated trading algorithm). This sets the global awareness for the AI engine.

Step 2: Highlight Code

Open the file you are working on and highlight the specific block of code, logical bottleneck, or runtime error message within your editor window. If no text is selected, the engine will safely evaluate the active file as context.

Step 3: Trigger an Analysis Action

With your sidebar view active, select one of the core interactive modules:

Analyze Selection: Submits a targeted snapshot to scan for hidden syntax or logic defects.

Structure: Launches an interactive, multiple-choice architectural challenge to map out system design patterns.

Logic Mapping: Scans your workspace for key variables and lists candidates for interactive state-mutation tracking.

(Alternatively, you can trigger a direct analysis from the editor by pressing Ctrl+Shift+P / Cmd+Shift+P, typing Socratic: Analyze Selection, and pressing Enter).

Step 4: Engage via Follow-Up Dialogue

Review the targeted, guiding questions and external documentation hyperlinks populated in the sidebar. Use the text input field at the bottom of the panel to answer the prompt sequences, explore variable lifecycles, or ask clarifying questions to isolate errors independently.

Core Learning Mechanics

Explicit Selection Capture: Evaluates precise code snapshots only when deliberately invoked by the user, ensuring total control over what context is sent to the Socratic engine.

Socratic Prompt Architecture: Replaces generic code-generation blocks with conceptual questions that prompt developers to mentally trace data streams and conditional states.

External Documentation Linkage: Bridges the gap between localized debugging and structural engineering principles by linking directly to official technical reference materials.