Synapse VS Code Extension
The leading open-source AI code assistant for VS Code. Create, share, and use custom AI assistants with powerful autocomplete, chat, edit, and agent capabilities.
✨ Features
🤖 Agent Mode
Make substantial changes to your entire codebase with AI assistance. The agent can understand your project structure and make coordinated changes across multiple files.
Key Commands:
Cmd/Ctrl + L - Add highlighted code to context and clear chatCmd/Ctrl + Shift + L - Add highlighted code to context
💬 AI Chat
Get help from LLMs without leaving your IDE. Ask questions, get explanations, and receive coding assistance in real-time.
Features:
- Context-aware conversations
- File and code selection integration
- Multiple model support
- Session management with history
✏️ Inline Edit
Modify code directly in your editor using natural language instructions. Perfect for quick fixes and improvements.
Key Commands:
Cmd/Ctrl + I - Edit highlighted code with natural languageShift + Cmd/Ctrl + Enter - Accept diffShift + Cmd/Ctrl + Backspace - Reject diffEscape - Exit edit mode
🔄 Tab Autocomplete
Get intelligent code suggestions as you type, powered by AI models that understand your codebase context.
Key Commands:
Cmd/Ctrl + K, Cmd/Ctrl + A - Toggle autocomplete enabled/disabledCmd/Ctrl + Alt + Space - Force autocompleteTab - Accept suggestionEscape - Reject suggestion
⚡ Quick Actions
Right-click context menu actions for common coding tasks:
- Write Comments - Generate comments for selected code
- Write Docstrings - Create documentation for functions/classes
- Fix Code - Automatically fix bugs and issues
- Optimize Code - Improve performance and readability
- Fix Grammar/Spelling - Correct text in markdown files
🛠️ Advanced Features
Codebase Indexing
- Intelligent codebase understanding and search
- Automatic indexing with manual re-index options
- Context-aware suggestions based on your project
Terminal Integration
Cmd/Ctrl + Shift + R - Debug terminal with AI assistance- Terminal context understanding for better suggestions
Configuration Management
- JSON and YAML configuration support with validation
- Schema-based autocompletion for config files
- Remote configuration syncing for teams
Custom Prompt Language
.prompt file support with syntax highlighting- File completion with
@ symbol
- YAML header support for prompt metadata
Multi-Model Support
- Support for various AI models (GPT, Claude, Mistral, etc.)
- Custom model configuration
- Enterprise license key support
🚀 Getting Started
Installation
- Install from VS Code Marketplace
- Open VS Code and look for the Synapse icon in the activity bar
- Configure your preferred AI model in settings
Quick Start
- Select code and press
Cmd/Ctrl + L to start a chat
- Highlight code and press
Cmd/Ctrl + I to edit inline
- Start typing to get autocomplete suggestions
- Right-click on code for quick actions
⌨️ Keyboard Shortcuts
| Action |
Mac |
Windows/Linux |
| Focus Chat |
Cmd + L |
Ctrl + L |
| Add to Context |
Cmd + Shift + L |
Ctrl + Shift + L |
| Inline Edit |
Cmd + I |
Ctrl + I |
| Accept Diff |
Shift + Cmd + Enter |
Shift + Ctrl + Enter |
| Reject Diff |
Shift + Cmd + Backspace |
Shift + Ctrl + Backspace |
| Toggle Autocomplete |
Cmd + K, Cmd + A |
Ctrl + K, Ctrl + A |
| Force Autocomplete |
Cmd + Alt + Space |
Ctrl + Alt + Space |
| Debug Terminal |
Cmd + Shift + R |
Ctrl + Shift + R |
| Open in New Window |
Cmd + K, Cmd + M |
Ctrl + K, Ctrl + M |
🔧 Configuration
The extension supports extensive configuration through:
- VS Code Settings - Basic preferences and feature toggles
.synapserc.json - Project-specific configurationconfig.yaml - Advanced configuration with YAML support- Remote Config - Team-wide configuration syncing
Key Settings
synapse.enableTabAutocomplete - Enable/disable autocompletesynapse.enableQuickActions - Enable experimental quick actionssynapse.telemetryEnabled - Control telemetry collectionsynapse.enableConsole - Enable debug console
🏗️ Development
Building the Extension
npm install
npm run esbuild
Running Tests
npm test
npm run e2e:all # End-to-end tests
Packaging
npm run package
📚 Documentation
🤝 Contributing
We welcome contributions! Please see our Contributing Guide and join the #contribute channel on Discord.
📄 License
Apache 2.0 © 2023-2025 Synapse Dev, Inc.
