# Using the VS Code Extension

The Morphy extension brings the agent into your editor — a full chat sidebar with sessions,
settings, file attachments, and voice input, right next to your code.

## Install

In VS Code, open **Extensions** (`Ctrl/Cmd+Shift+X`), search for **Morphy**, and install it.
Or from the command palette:

```
ext install deadraid.morphy-vscode
```

For VSCodium / Cursor and other editors, install **Morphy** from the Open VSX registry.

The extension bundles the Morphy engine, so it works on its own. If you already have the CLI
installed and want the extension to use it, set its path in settings (see below).

## Opening Morphy

- Click the **Morphy** icon in the activity bar (left sidebar) to open the panel, or
- Run **Morphy: Open Panel** from the command palette (`Ctrl/Cmd+Shift+P`).

## What you can do

- **Chat** with the agent using streaming replies, markdown, and code highlighting.
- **Attach files** from your workspace to a message.
- **Voice input** — dictate prompts.
- **Manage sessions** — start new ones, switch between them, keep history.
- **Configure providers, models, and settings** from inside the panel — shared with the CLI
  and desktop app (same `~/.morphy` data).

## Commands

Available from the command palette:

| Command | What it does |
| --- | --- |
| **Morphy: Open Panel** | Open the Morphy sidebar |
| **Morphy: New Session** | Start a fresh session |
| **Morphy: Refresh Sessions** | Reload the session list |
| **Morphy: Restart Server** | Restart the underlying Morphy engine |

## Settings

Open **Settings** and search for "Morphy". The most useful ones:

| Setting | Purpose |
| --- | --- |
| `morphy.executablePath` | Path to a `morphy` binary to use instead of the bundled engine |
| `morphy.defaultProvider` | Provider used for new sessions |
| `morphy.defaultModel` | Model used for new sessions |
| `morphy.permissionMode` | `safe` / `normal` / `auto` / `yolo` for new sessions |
| `morphy.applyWorkbenchTheme` | Also apply Morphy themes to the whole VS Code workbench |
| `morphy.swarm.agentCount` | Default number of agents for swarm runs |
| `morphy.swarm.maxCycles` | Default maximum cycles for swarm runs |

See [LLM Providers](providers.md) to connect a provider, and
[Permission modes](cli.md#permission-modes) for what each mode does.

## Themes

The extension ships several editor themes — **Morphy Dark/Light**, **Monikai**,
**Tokyo Night**, **Nord**, **Solarized**, and **Vesper**. Pick one from
**Preferences: Color Theme**.

## Connecting a provider

The first time, open the Morphy panel, go to settings inside it, add your provider account and
API key, and choose a model — exactly like the CLI. Keys are stored in the same encrypted
[vault](configuration.md#secrets-vault). Full steps in [LLM Providers](providers.md).