Complete reference for all Misar Code extension settings configurable in VS Code.

Overview

All settings are configurable via File → Preferences → Settings or by editing settings.json directly. Settings prefixed with misar. apply to the agent and API; settings prefixed with misarCode. apply to the editor integration.

Connection

Setting	Type	Default	Description
`misar.apiKey`	string	`""`	Your Misar Code API key. Get one from the dashboard.
`misar.apiBaseUrl`	string	`"https://api.misar.io/dev"`	Base URL for the Misar Code backend. Change this only if you are running a self-hosted instance.

Agent Behaviour

Setting	Type	Default	Description
`misar.permissionMode`	enum	`"default"`	Controls how the agent handles potentially destructive actions. `"default"` — ask before dangerous tools; `"strict"` — ask before all write tools; `"unrestricted"` — never ask (use with caution).
`misar.autoAcceptChanges`	boolean	`false`	Automatically accept all file changes proposed by the agent without showing a diff preview.
`misar.autosaveOnAccept`	boolean	`true`	Save the file immediately after accepting a proposed change.
`misar.persona`	enum	`"default"`	Agent persona preset that shapes tone and response style. Options: `"default"`, `"concise"`, `"verbose"`, `"mentor"`.
`misar.systemPrompt`	string	`""`	Additional system prompt appended to the agent's default instructions on every session.

Chat Panel

Setting	Type	Default	Description
`misar.preferredLocation`	enum	`"sidebar"`	Where the chat panel opens. `"sidebar"` — Activity Bar panel; `"panel"` — bottom panel.
`misar.maxHistoryItems`	number	`50`	Maximum number of conversation turns to retain in session history.
`misar.showDetailedProgress`	boolean	`false`	Show detailed per-tool progress messages in the chat panel during agent runs.
`misar.useCtrlEnterToSend`	boolean	`false`	When `true`, `Ctrl+Enter` sends a message and `Enter` inserts a newline. Useful for multi-line inputs.

Editor Integration

Setting	Type	Default	Description
`misarCode.showEditorIcon`	boolean	`true`	Show the Misar Code icon button in the editor title bar.
`misarCode.showStatusBarItem`	boolean	`true`	Show the Misar Code status indicator in the VS Code status bar.
`misarCode.codeLens`	boolean	`true`	Show AI action CodeLens links (Explain / Fix / Test) above functions and classes.
`misarCode.inlineEditMode`	boolean	`true`	Enable inline edit mode, which shows diffs directly in the editor rather than in a separate panel.
`misarCode.autoContext`	boolean	`true`	Automatically inject the active file, selected text, and related files as context with each message.

Completions

Setting	Type	Default	Description
`misar.inlineCompletions`	boolean	`true`	Enable AI-powered inline code completions as you type.

Sessions

Setting	Type	Default	Description
`misarCode.restoreSessionHours`	number	`24`	How many hours to retain conversation history across VS Code restarts. Set to `0` to disable session persistence.

Example settings.json

{
  "misar.apiKey": "YOUR_API_KEY",
  "misar.permissionMode": "default",
  "misar.autosaveOnAccept": true,
  "misar.inlineCompletions": true,
  "misar.useCtrlEnterToSend": false,
  "misarCode.codeLens": true,
  "misarCode.inlineEditMode": true,
  "misarCode.restoreSessionHours": 24,
  "misarCode.autoContext": true
}

Workspace-level settings in .vscode/settings.json override user-level settings. Use this to enforce permissionMode or a custom apiBaseUrl for all contributors on a project.

Settings Reference