PorterCode for Visual Studio Code
AI-powered coding assistant that brings PorterCode's capabilities directly into VSCode.
Features
Chat Interface
- Multi-tab conversations: Open multiple chat sessions as tabs
- Real-time streaming: See AI responses as they're generated
- Tool execution: Watch tools being called with live status updates
- Reasoning display: View the AI's thinking process in collapsible sections
Code Integration
- Send selection: Send highlighted code to PorterCode with
Cmd+Shift+L
- Apply edits: One-click apply for suggested code changes
- Diff preview: Visual comparison of proposed changes
- Open in editor: Jump to referenced files directly
Session Management
- Session history: Browse and resume previous conversations
- Session persistence: Sessions sync with PorterCode CLI
- Quick switch: Switch between sessions from the sidebar
Permission System
- Smart prompts: Clear permission dialogs for tool execution
- Pattern matching: "Don't ask again" for similar operations
- Risk indicators: Visual cues for operation risk levels
Auto-Install & Update
- Automatic CLI installation: Extension installs PorterCode CLI automatically if not found
- Auto-update: Checks for newer CLI versions on startup and updates automatically
Requirements
- Node.js: Required for npm package installation
- VSCode: Version 1.85.0 or higher
Getting Started
Install the extension (VSIX file or marketplace)
Open PorterCode panel from the Activity Bar (left sidebar)
Configure API key (first time only) - The onboarding flow will guide you
Start chatting!
The extension automatically installs and manages the PorterCode CLI.
Keyboard Shortcuts
| Shortcut |
Action |
Cmd+Shift+N |
New chat session |
Cmd+Shift+L |
Send selection to chat |
Escape |
Cancel generation |
Extension Settings
| Setting |
Description |
Default |
portercode.autoConnect |
Auto-connect to CLI on startup |
true |
portercode.showStatusBar |
Show status in status bar |
true |
portercode.cliPath |
Custom path to CLI (auto-detect if empty) |
"" |
Development
Build from source
cd portercode-vscextension
npm install
npm run build
npm run package
Watch mode
npm run watch
Troubleshooting
Extension not connecting
- Check the Output panel for errors (View → Output → PorterCode)
- Ensure Node.js is installed (for CLI auto-install)
- Reload VSCode window
Messages not appearing
- Check the Output panel for errors
- Verify the CLI is running (check for
porter process)
License
Proprietary - See LICENSE for details.
Copyright (c) 2025 Carlos Alexis Gomez Ruiz and Porter Metrics Inc. All rights reserved.
| |
