​
What You Can Do

The SynapseX VS Code extension empowers you to accomplish a wide range of development tasks with AI assistance:

​
Create New Projects

  • Project Generation: Describe your project and let AI create the initial structure
  • Framework Setup: Get help setting up React, Next.js, FastAPI, or any other framework
  • Boilerplate Code: Generate starter templates for common project types
  • Configuration Files: Auto-generate package.json, requirements.txt, Dockerfile, and other config files
> create a full-stack Next.js app with PostgreSQL and authentication
> scaffold a Python FastAPI microservice with Docker
> generate a React TypeScript component library

​
Improve Existing Projects

  • Code Review: Get AI feedback on your existing code
  • Bug Fixes: Identify and resolve issues in your codebase
  • Feature Addition: Add new functionality with AI assistance
  • Code Optimization: Improve performance and code quality
  • Documentation: Generate comments and documentation for your code
> review this function and suggest improvements
> add proper error handling to my API endpoints
> generate JSDoc for all exported functions in this file

​
Real-Time Development

  • Code Completion: Smart suggestions as you type
  • Error Resolution: Instant help with compilation and runtime errors
  • Refactoring: Improve code structure and organization
  • Testing: Generate unit tests and test cases
  • Debugging: Get help understanding and fixing complex issues

​
Multiple AI Models

Choose from different AI models based on your preference and project requirements. Switch between various AI models to find the one that best suits your coding style and the complexity of your tasks. Available models include:
  • SynapseX Default — Optimized for coding tasks
  • Claude Sonnet 4 — Complex reasoning and architecture design
  • GPT-5 Codex — Advanced code generation
  • Gemini 2.5 Pro — Long context windows
  • DeepSeek R1 — Reasoning and debugging

​
Rich Context Integration

Enhance your AI conversations by adding comprehensive context from multiple sources. Import context from:
  • 📁 Files and folders in your project
  • 🔗 Web URLs — documentation, APIs, tutorials
  • 📝 Git commits — reference specific changes
  • 🗂️ Entire projects — full codebase understanding

​
Git Commit Context

Reference specific Git commits directly in your conversations to provide relevant historical context. This feature allows the AI to understand changes made in previous commits and helps maintain consistency across your development workflow. 
> based on commit abc1234, why did we change the authentication flow?
> continue implementing the feature started in the last 3 commits

​
Web URL Integration

Include web resources and documentation directly in your development workflow. Pull context from online resources, documentation, or any web-based content. 
> implement this API based on the docs at https://stripe.com/docs/api
> create a component following the patterns from https://ui.shadcn.com

​
Conversation History

Access a rich history of all your previous conversations with the AI. Continue where you left off, revisit previous solutions, or reference past discussions to maintain continuity in your development process.

​
Voice Interaction Mode

When your hands are busy and you can’t type, voice mode has you covered. Communicate with the AI using voice commands, making it possible to continue coding even when you’re away from the keyboard or need hands-free interaction.
Voice Mode is powered by ElevenLabs for high-quality speech recognition and synthesis. Learn more about Voice Mode →

​
Auto Mode

Tired of manually giving permission for every command? Auto mode streamlines your workflow by automatically executing approved actions.
Use Auto Mode responsibly. Always review changes before committing to version control, especially on critical system files or production code.

​
Tool Configuration

Use SynapseX VS Code Agent Tools to enable additional functionality:
ToolDescription
BrowserLaunch and control a browser, capture screenshots, test web apps
TerminalExecute shell commands and scripts
File SystemCreate, read, edit, and organize files
GitManage version control operations
MCP ServersConnect to external tools and data sources

​
Background CLI Tasks

Background CLI tasks facilitate running multiple tasks in parallel. To run a background task, use the /cli command: 
/cli run tests for the entire project
/cli build and deploy the Docker image
/cli install all dependencies and start the dev server
When you type /cli, you’ll also see a dropdown to choose where the command should run:
  • Workspace — runs in your current workspace folder
  • Worktree — creates a fresh worktree-<timestamp> git worktree and runs inside it for isolation
It is recommended to run sessions in Worktree mode to avoid conflicts with other parallel sessions.

​
Merging Changes from Worktree Sessions

Using Git: 
# Review changes
git status
git diff

# Commit in worktree
git add .
git commit -m "feat: implement new feature via SynapseX"

# Switch to main branch and merge
git checkout main
git merge worktree-<timestamp>
Using VS Code:
  1. Open the Worktree folder in VS Code Explorer
  2. Open Source Control (Ctrl+Shift+G)
  3. Stage, diff, and commit changes
  4. Use Git: Merge Branch… from the Command Palette (Ctrl+Shift+P)
  5. Delete the worktree folder after merging

​
SynapseX Skills

SynapseX Skills are reusable, discoverable capabilities that package expert workflows into a single place. Each Skill is defined by a SKILL.md with clear instructions and optional supporting files (scripts, templates, examples). The agent autonomously decides when to use a Skill based on your request and the Skill description. This lets you:
  • Extend the agent for your specific workflows
  • Share expertise via git
  • Avoid repetitive prompting
Store project Skills in .synapsex/skills/: 
mkdir -p .synapsex/skills/my-skill-name

​
Write SKILL.md

---
name: your-skill-name
description: Brief description of what this Skill does and when to use it
---

# Your Skill Name

## Instructions
Provide clear, step-by-step guidance for SynapseX agents.

## Examples
Show concrete examples of using this Skill.
Field requirements:
  • name: Must use lowercase letters, numbers, and hyphens only (max 64 characters)
  • description: What the Skill does and when to use it (max 1024 characters)
The description field is critical for SynapseX to discover when to use your Skill. Include both what it does and when the agent should apply it.

​
Development Superpowers

The SynapseX VS Code extension is a powerful AI development tool designed to boost your productivity 10x. With these advanced features, you have access to cutting-edge AI capabilities that enhance every aspect of your development workflow. From initial project setup to final deployment, the AI agent is your comprehensive coding companion that helps you write better code faster.

Getting Started

Install and configure the extension

Orchestration

Run multiple sub-agents in parallel