Settings and Configuration

DevSpeak exposes several configuration options through VS Code's standard settings system.

Extension Settings

Open Settings (Cmd+, / Ctrl+,) and search for devspeak to see all available options:

| Setting | Default | Description |

| --------------------------------- | -------------------------- | ---------------------------------------------------------------------------------------- |

| devspeak.apiEndpoint | https://www.devspeak.dev | DevSpeak API base URL |

| devspeak.defaultAudience | Senior Dev | Default target audience for new translations |

| devspeak.defaultContext | Backend | Default technical context |

| devspeak.defaultFormat | Technical Spec | Default output format |

| devspeak.defaultTone | 75 | Default tone slider value (10–90) |

| devspeak.enableCodeLens | true | Show CodeLens above annotated comments |

| devspeak.correctionsOnly | false | Optimize fixes spelling, grammar and punctuation only; off improves the whole text |

| devspeak.enableWorkspaceContext | true | Include workspace metadata in requests |

| devspeak.notifyOnCompletion | true | Notify when a translation finishes unseen |

| devspeak.telemetry.enabled | false | Share anonymous usage telemetry (opt-in) |

| devspeak.customInstructions | "" | Custom instructions sent with every request (VIBECODER, DEVELOPER, and ENTERPRISE plans) |

Workspace Context

When devspeak.enableWorkspaceContext is enabled, DevSpeak automatically includes metadata about your current project — language, framework, and key dependencies — in every translation request. This produces more relevant, context-aware output without manual configuration.

Completion Notifications

Translations keep running when you close the DevSpeak panel or switch to another window, so a result can finish without you seeing it. With devspeak.notifyOnCompletion enabled, you get a notification when that happens, with a button that reopens the panel.

It is on by default, and never appears while you are watching the panel — the in-panel progress report already shows you the result arriving.

Commands

All commands are accessible from the Command Palette (Ctrl+Shift+P / Cmd+Shift+P):

| Command | Shortcut | Description |

| --------------------------------- | ------------------------------ | ----------------------------------- |

| DevSpeak: Login | — | Sign in via OAuth or API key |

| DevSpeak: Translate Selection | Cmd+Shift+T / Ctrl+Shift+T | Translate the selected text |

| DevSpeak: Optimize Text | — | Optimize the selected text in place |

| DevSpeak: Settings | — | Open DevSpeak settings |

| DevSpeak: Show Output Log | — | Open the DevSpeak output channel |

| DevSpeak: Clear History | — | Remove all history entries |

| DevSpeak: Logout | — | Sign out of the current session |

Dark and Light Theme

The extension inherits the active VS Code color theme automatically. Both dark and light themes are fully supported.

Language Support

The extension UI is available in English and Spanish. It follows the VS Code display language setting.

Cross-Platform Compatibility

DevSpeak targets extensionKind: ["ui"] and uses standard VS Code APIs. It is verified to work in:

  • Visual Studio Code (desktop)
  • Cursor (via .vsix sideload or Open VSX)
  • Windsurf (via .vsix sideload)