Settings Reference

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.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
}