​
Overview

Getting the most from the SynapseX VS Code Agent is about understanding how to communicate effectively, leverage context, and integrate AI into your development workflow. These best practices are gathered from real-world usage across thousands of projects.

​
Maximize Context

The quality of SynapseX’s responses is directly tied to the quality and quantity of context it has access to.

​
Select Relevant Code

Before asking a question or making a request, select the specific code you’re asking about. SynapseX will use the selection as the primary context for its response. 
# Good — with selection context
[Select the authenticate() function]
> "Why is this function not handling expired tokens correctly?"

# Less effective — no selection
> "Why is the token not working?"

​
Add Rich Context

Use the Add Context button to attach multiple context sources:
  • Files — include related modules, models, or utility files
  • Folders — attach an entire feature directory for large-scale tasks
  • Git Commits — show recent history for refactoring or debugging tasks
  • URLs — add documentation, GitHub issues, or API reference pages

​
Be Specific

Precise queries yield precise results:
Vague QuerySpecific Query
”Fix this""Fix the race condition in the payment processing queue when two requests arrive within 50ms"
"Make it better""Refactor this function to reduce cyclomatic complexity and add TypeScript strict types"
"Add tests""Add Jest unit tests with 90% coverage for the UserAuthService class, including edge cases for expired tokens”

​
Iterate and Refine

Don’t expect perfection on the first try. Use conversation history to refine: 
> "Add user authentication to the API"
> "Now add rate limiting — 100 requests per minute per user"
> "Add a refresh token endpoint and update the middleware"

​
Leverage Advanced Features

​
Choose the Right Model

Different models excel at different tasks:
TaskRecommended Model
Complex reasoning, architecture designClaude Sonnet 4 / Claude Opus 4
Rapid code generationGPT-4o / GPT-5
Large file analysis, long codebasesGemini 2.5 Pro
Fast iterations, quick fixesClaude Haiku 3.5
Research and web-augmented tasksPerplexity Sonar Pro
Cost-sensitive high-volume tasksDeepSeek V3
Switch models mid-conversation by clicking the model selector — SynapseX preserves the full conversation context when switching.

​
Use Voice Mode for Flow State

Voice Mode is ideal for:
  • Extended coding sessions where typing slows your thinking
  • Architectural discussions where you want to talk through design decisions
  • Debugging narration — describe what you’re observing while SynapseX listens
  • Code reviews where you speak feedback as you scroll through changes
See Voice Mode for setup instructions.

​
Visual Context with Screenshots

Capture UI bugs, design mockups, or terminal error screenshots and add them directly to the SynapseX chat. The model will analyze the visual content and provide code solutions grounded in what it sees. 
[Take screenshot of broken layout]
> "Fix the CSS so the sidebar doesn't overlap the main content on mobile"

​
Use Auto Mode for Long Tasks

Enable Auto Mode (fully autonomous) when you want SynapseX to complete a task end-to-end without asking for approvals:
  1. Open Settings → Tool Configuration
  2. Enable Auto-Approve for terminal commands and file edits
  3. Give SynapseX a high-level task
> "Set up the entire testing infrastructure: install Jest, write tests for all service
  classes, add coverage reporting, and update the CI workflow"
SynapseX will complete the full task autonomously.

​
Review Conversation History

SynapseX maintains full conversation history. Use it to:
  • Resume tasks from a previous session
  • Reference previous code without retyping
  • Track decision rationale for architectural choices

​
Efficient Workflow

​
Stay in Flow

Minimize context-switching by keeping SynapseX focused on the current task:
  • Keep the SynapseX panel open alongside your editor (split view)
  • Use keyboard shortcuts to trigger SynapseX without mouse navigation
  • Add frequently-used files to workspace context once and reuse across queries

​
Keyboard Shortcuts

ActionShortcut
Open SynapseX PanelCtrl+Shift+A / Cmd+Shift+A
Focus Chat InputCtrl+Shift+Enter / Cmd+Shift+Enter
New Chat SessionCtrl+Shift+N / Cmd+Shift+N
Toggle Voice ModeClick microphone in toolbar

​
Incremental Development

Break large features into incremental steps: 
# Step 1 — Design
> "Design the database schema for a multi-tenant SaaS platform"

# Step 2 — Implement
> "Now implement the UserTenant model with Prisma ORM"

# Step 3 — API Layer
> "Create FastAPI endpoints for tenant creation and user assignment"

# Step 4 — Tests
> "Write integration tests for the tenant management endpoints"

​
Code Reviews

Use SynapseX for fast self-reviews before submitting PRs: 
> "Review this PR diff for security vulnerabilities, performance issues, and code style violations"
[Attach the diff or select changed files]

​
Git Context for Bug Fixes

When debugging a regression, attach git commit context to help SynapseX understand what changed and when: 
[Add context: last 5 commits]
> "The payment webhook stopped working after last Wednesday. Find which commit broke it and fix it."

​
Context Management Strategies

​
Web Resources

For tasks involving third-party APIs or libraries, attach the relevant documentation URL: 
[Context: https://stripe.com/docs/webhooks]
> "Implement Stripe webhook handling with proper signature verification"

​
Commit History for Debugging

When tracing bugs, include recent commits: 
[Add context: git log --since="1 week ago"]
> "There's a memory leak that started this week. Identify which change introduced it."

​
File Organization

Maintain clean workspace structure — SynapseX navigates your project better when files follow consistent naming and organization patterns.

​
URL Integration

SynapseX can read any public URL. Use this for:
  • GitHub Issues and PRs
  • API documentation
  • Technical articles or RFC specifications
  • Competitor code or examples

​
Pro Tips

Use cheaper, faster models for simple tasks (variable renaming, docstrings, simple refactors) and premium models for complex reasoning (architecture design, security audits, large refactors). This reduces cost while maintaining quality where it matters.
Too much context can dilute the response. Add only the most relevant files. For a bug fix, attach the specific file and its direct dependencies — not the entire project.
Use voice for high-level planning conversations (“how should we architect this?”) and switch to text for precise code requests that require exact variable names or syntax.
Enable Auto Mode only for well-defined, scoped tasks. For exploratory or ambiguous tasks, keep approval mode on so you can guide the direction at each step.
Start a new conversation for unrelated tasks to prevent context confusion. Use conversation history to continue tasks across sessions on the same feature branch.
Combine screenshots with Figma exports or design mockups to implement UI from visual specifications directly, reducing back-and-forth with designers.

​
Workflow Integration

​
Daily Development Routine

  1. Morning standup: Paste yesterday’s TODO and ask SynapseX to suggest the optimal task sequence
  2. Feature work: Use incremental development with Auto Mode for boilerplate-heavy tasks
  3. Before PR: Run a SynapseX code review with security and style checks
  4. End of day: Ask SynapseX to summarize what was accomplished and draft the next day’s plan

​
Collaboration Enhancement

  • Share SynapseX-generated code explanations with teammates unfamiliar with a module
  • Use SynapseX to generate PR descriptions with context from git commits
  • Leverage SynapseX to write onboarding documentation from existing code

​
Learning and Growth

Use SynapseX as a learning tool: 
> "Explain how this Redis caching implementation works and what design patterns it uses"
> "What are the trade-offs between this implementation and using a message queue?"
> "Show me how this could be improved using the Circuit Breaker pattern"

Voice Mode

Hands-free coding with ElevenLabs

Orchestration

Run multiple agents in parallel

Key Features

Full feature reference

Getting Started

Install and configure SynapseX