Skip to main content
Embedder VS Code extension showing the chat panel, code editor, and serial console side by side
The Embedder VS Code extension provides a graphical interface for Embedder directly in your IDE. This is the recommended way to to use Embedder in VS Code and for Windows users. With the extension, you get all the core functionality of the CLI: a serial monitor, review and edit plans, @ mentioning files, sending serial commands, accessing conversation history, open multiple conversations in separate tabs, and more.

Install the extension

Or in VS Code, press Cmd+Shift+X on Mac or Ctrl+Shift+X on Windows and Linux to open the Extensions view, search for “Embedder”, and click Install.
If the extension doesn’t appear after installation, restart VS Code or run “Developer: Reload Window” from the Command Palette.

Get started

Once installed, you can use Embedder natively in your IDE.
1

Open the Embedder panel

The quickest way to open Embedder is to click the icon from the Activity Bar on the left side of your screen.Another way to open Embedder is through the Command Palette. Use Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows/Linux), type “Embedder”, and select “New Chat Tab”.
2

Send a prompt

Ask Embedder to help with your code or files, whether that’s explaining how something works, debugging an issue, or making changes. See common workflows for more examples of things you can do with Embedder.
3

Configure project

  1. Choose an existing project or create a new one
  2. Select the platform you’re using from our catalog, or add your own
  3. Select the peripherals you’re using from our catalog, or add your own
  4. Generate EMBEDDER.md with /init
See common workflows for more information on project configuration.
4

Review the changes

When Embedder wants to edit a file, it shows a comparison of the proposed changes, then asks for permission. You can accept, reject, or tell Embedder what to do instead.
Permission request dialog showing a comparison of proposed file changes

VS Code commands and shortcuts

Open the Command Palette (Cmd+Shift+P on Mac or Ctrl+Shift+P on Windows/Linux) and type “Embedder” to see all available VS Code commands for the Embedder extension.
These are VS Code commands for controlling the extension. Not all built-in Embedder commands are available in the extension.
CommandDescription
Open Embedder ChatOpens the Embedder chat panel
Switch Mode (Act/Plan)Toggle between Act and Plan modes
New Chat TabCreates a new chat tab
Close Active Chat TabCloses the current chat tab
Restart CLI ServerRestarts the CLI backend process
Switch ModelChange the AI model
Stop GenerationStop the current AI response
Install Embedder CLIInstall the CLI binary
Clear ConversationClear chat history
Compress ConversationCompress conversation to save tokens
View Usage & BillingView usage statistics
View Conversation HistoryBrowse past conversations
Switch TeamChange active team
Switch ProjectChange active project
Undo Last MessageUndo the last message
Open Web ConsoleOpen web console
Open CLI LogsView CLI log files
Show CLI Process OutputShow CLI process stdout
Open Embedder Console (Panel)Open serial console in panel
Open Embedder Console in EditorOpen serial console as editor tab
Toggle Embedder ConsoleToggle serial console visibility

Rewind with checkpoints

The VS Code extension supports checkpoints, which track Embedder’s file edits and let you rewind to a previous state. Click the rewind button on any message, or use the /undo or /rewind commands, to choose from three options:
  • Fork conversation from here — Start a new conversation branch from this message while keeping all code changes intact.
  • Rewind code to here — Revert file changes back to this point in the conversation while keeping the full conversation history.
  • Fork conversation and rewind code — Start a new conversation branch and revert file changes to this point.

Serial console

Embedder can interact with your serial console directly. It can read serial output history to diagnose issues, send commands to your device, monitor for specific patterns, and help debug communication problems. The built-in serial console lets you communicate with embedded devices directly from VS Code. Open it from the bottom panel or as a full editor tab with the embedder.openSerialInEditor command.
Serial console showing device output alongside the code editor

Port selection

Embedder auto-detects available serial ports and displays metadata like manufacturer, vendor/product ID, and serial number. Ports refresh automatically when devices are plugged in or unplugged.

Baud rate

Select from common baud rates manually, or let Embedder auto-detect the correct baud rate. Auto-detection shows a confidence level so you know how reliable the result is.

Multi-tab interface

Open multiple serial connections simultaneously. Each tab maintains its own port selection, baud rate, connection state, output history (up to 50,000 lines), filter pattern, and timestamp settings.

Output features

  • Log level coloring — Errors appear in red, warnings in yellow, info in green, and debug in blue.
  • Timestamps — Optional timestamp prefix for each line.
  • Regex filtering — Filter output with regular expressions.
  • Clear output — Clear the console while preserving the connection.

Connection types

Embedder supports two connection types:
TypeDescription
UARTStandard serial port connections (USB-to-UART adapters, dev boards)
RTTSEGGER Real-Time Transfer via J-Link probes
Embedder automatically detects connected J-Link probes and supports RTT for non-intrusive debugging output. Select your target device from a picker with search and filter, with suggested devices based on your project context. Supports both SWD and JTAG interfaces.

Next steps

Common workflows

Explore practical examples of what you can do with Embedder.

Best practices

Learn tips and techniques to get the most out of Embedder.
Last modified on March 5, 2026