> ## Documentation Index
> Fetch the complete documentation index at: https://docs.prescaler.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Settings reference

> Searchable reference generated from registered IDE settings.

Use the Settings search box for these labels. Prefer Build Setup and Target Configuration for project-specific choices. Defaults shown here are literal registry defaults; native configuration and project overrides may take precedence. Computed registrations are not inferred.

## Play sound on terminal bell

**Key:** `accessibility.signals.terminalBell` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Downloads

**Key:** `ai.browser.downloads` · **Type:** boolean

Allow saving downloaded files into the open project.

**Registry default:** `false`

## Browser tools

**Key:** `ai.browser.enabled` · **Type:** boolean

Allow agents to use fetch\_url and related browser helpers.

**Registry default:** `true`

## Network requests

**Key:** `ai.browser.network` · **Type:** boolean

Allow HTTP(S) requests from browser and fetch tools.

**Registry default:** `false`

## Attachment character limit

**Key:** `ai.context.attachmentLimit` · **Type:** number

Maximum characters from attached IDE context per turn.

**Registry default:** `10000`

## Context budget

**Key:** `ai.context.budgetTokens` · **Type:** number

Maximum project-context tokens sent with one turn.

**Registry default:** `4000`

## Apply workspace customize files

**Key:** `ai.customize.enabled` · **Type:** boolean

Inject enabled rules, skills, and subagent templates from .prescaler/.

**Registry default:** `true`

## Custom model profiles

**Key:** `ai.customModels` · **Type:** custom

Saved user models and local or compatible API endpoints. Credentials are stored in the OS keychain.

**Registry default:** Determined by the implementation or project.

## Strict hardware grounding

**Key:** `ai.grounding.strict` · **Type:** boolean

Require project, SVD, datasheet, or errata evidence for hardware claims.

**Registry default:** `true`

## Confirm hook actions

**Key:** `ai.hooks.confirm` · **Type:** boolean

Ask before a hook runs a command.

**Registry default:** `true`

## Enable hooks

**Key:** `ai.hooks.enabled` · **Type:** boolean

Run configured actions around agent sessions.

**Registry default:** `false`

## Model

**Key:** `ai.model` · **Type:** custom

Choose Auto or a model from Chats. Available models come from your account.

**Registry default:** `"auto"`

## Permission mode

**Key:** `ai.permissions.mode` · **Type:** custom

See the owning feature guide for operation prerequisites.

**Registry default:** `"askRisky"`

## Custom rules

**Key:** `ai.permissions.rules` · **Type:** custom

Per-command and per-file allow/deny overrides.

**Registry default:** Determined by the implementation or project.

## Update automatically

**Key:** `ai.plugins.autoUpdate` · **Type:** boolean

Re-apply bundled plugin updates when the IDE starts.

**Registry default:** `true`

## Enable plugins

**Key:** `ai.plugins.enabled` · **Type:** boolean

Allow installed extensions to add agent tools and context.

**Registry default:** `true`

## Third-party plugins

**Key:** `ai.plugins.thirdParty` · **Type:** boolean

Allow plugins that are not published by Prescaler, including local ones.

**Registry default:** `false`

## Include cppcheck in Run All Checks

**Key:** `analysis.cppcheck.enabled` · **Type:** boolean

When off, Diagnose / Run All Checks still scans conflicts but skips cppcheck.

**Registry default:** `true`

## MISRA severity shown

**Key:** `analysis.misra.level` · **Type:** select

Loosest MISRA C:2012 category still shown in Checks → MISRA. Anything stricter is always included.

**Registry default:** `"required"`

## MISRA suppressions file

**Key:** `analysis.misra.suppressionsFile` · **Type:** path

Passed to cppcheck's real MISRA addon as --suppressions-list=\<path>. Project-relative path to a suppressions file listing rule/file/line exceptions.

**Registry default:** `""`

## Run cppcheck after successful builds

**Key:** `analysis.runOnBuild` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `false`

## Run cppcheck on save

**Key:** `analysis.runOnSave` · **Type:** boolean

After saving an editor file, run static analysis on the project.

**Registry default:** `false`

## Stack usage warning threshold (bytes)

**Key:** `analysis.stackUsageWarningBytes` · **Type:** number

Functions whose real worst-case call-path stack usage (GCC -fstack-usage + call graph) reaches this many bytes are flagged in Checks → Stack Usage.

**Registry default:** `1024`

## Color theme

**Key:** `appearance.theme` · **Type:** select

Prescaler Copper (dark) or the warm paper-toned light theme.

**Registry default:** `"dark"`

## Breadcrumbs

**Key:** `breadcrumbs.enabled` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Auto save before build

**Key:** `build.autoSaveBeforeBuild` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## CMake build preset

**Key:** `build.buildPreset` · **Type:** string

Exact build preset name. CMake owns inheritance, toolchain, output directory, and flags.

**Registry default:** `""`

## Clear output on new build

**Key:** `build.clearOutputOnRun` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## CMake configure preset

**Key:** `build.configurePreset` · **Type:** string

Exact configure preset name from CMakePresets.json or CMakeUserPresets.json.

**Registry default:** `""`

## Default build configuration

**Key:** `build.defaultConfiguration` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"Debug"`

## CMake generator

**Key:** `build.generator` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"auto"`

## Link-time optimization (Release)

**Key:** `build.linkTimeOptimization` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `false`

## Native build environment

**Key:** `build.nativeConfiguration` · **Type:** string

Selected PlatformIO environment. Prefer the discovered choices in Build Setup.

**Registry default:** `""`

## Parallel build jobs

**Key:** `build.parallelJobs` · **Type:** number

0 = auto.

**Registry default:** `0`

## Post-build command

**Key:** `build.postBuildHook` · **Type:** string

Executable invocation run in the project root after a successful build, e.g. to generate a .bin/.hex or sign an image. Matches STM32CubeIDE's post-build steps / PlatformIO's extra\_scripts.

**Registry default:** `""`

## Show flash/RAM size summary

**Key:** `build.showSizeSummaryAfterBuild` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## CMake toolchain file

**Key:** `build.toolchainFile` · **Type:** string

Optional project-relative path, for example cmake/arm-none-eabi.cmake.

**Registry default:** `""`

## Use ccache if available

**Key:** `build.useCcache` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `false`

## Verbose compiler/linker output

**Key:** `build.verboseOutput` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `false`

## Warnings as errors

**Key:** `build.warningsAsErrors` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `false`

## Zephyr board target

**Key:** `build.zephyrBoard` · **Type:** string

Exact board target from the installed SDK, including any revision or qualifiers.

**Registry default:** `""`

## Debug backend (default)

**Key:** `debug.backend` · **Type:** select

GDB server used to reach the target when the active Target Configuration does not set its own backend. pyOCD covers more Cortex-M/Nordic/RP2040 targets out of the box.

**Registry default:** `"openocd"`

## Confirm before stopping session

**Key:** `debug.confirmOnStop` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `false`

## Auto-decode Cortex-M fault registers

**Key:** `debug.faultAnalysis.autoDecode` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Memory view refresh rate (ms)

**Key:** `debug.memoryView.refreshRateMs` · **Type:** number

See the owning feature guide for operation prerequisites.

**Registry default:** `500`

## When to show the Debug panel

**Key:** `debug.openDebug` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"openOnFirstSessionStart"`

## Refresh registers on stop

**Key:** `debug.refreshRegistersOnStop` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Session type

**Key:** `debug.request` · **Type:** select

Launch resets the target before debugging (the normal case, right after flashing). Attach connects to whatever is already running without resetting or erasing it -- matches Cortex-Debug's request field.

**Registry default:** `"launch"`

## RTOS

**Key:** `debug.rtos` · **Type:** select

Auto-detects by probing the ELF’s debug symbols for a known kernel (pxCurrentTCB for FreeRTOS, \_kernel for Zephyr) the same way OpenOCD’s "-rtos auto" and VS Code’s Cortex-Debug do. Override only if auto-detect misses it — e.g. link-time optimization stripped the probe symbol, or the build links more than one kernel’s symbols. ThreadX, ChibiOS, embOS, and NuttX task lists aren’t implemented yet (each needs its own kernel struct layout); this only lets you force which of the two supported readers runs, or turn RTOS awareness off entirely.

**Registry default:** `"auto"`

## Low-stack warning threshold (words)

**Key:** `debug.rtos.lowStackWarningWords` · **Type:** number

A task’s stack high-water mark below this many 32-bit words is flagged in the RTOS tasks tab. FreeRTOS’s own docs suggest keeping at least 100–200 words of margin; there’s no universal safe number — it depends on your deepest interrupt nesting and worst-case call stack, so tune it per project rather than trusting one default.

**Registry default:** `128`

## RTT poll rate (ms)

**Key:** `debug.rtt.refreshRateMs` · **Type:** number

RTT already auto-discovers and displays every channel; this is only how often it polls for new data, matching the existing memory-view refresh setting.

**Registry default:** `500`

## ARM semihosting (default)

**Key:** `debug.semihosting.enabled` · **Type:** boolean

Enable printf/file I/O over the debug link (QEMU -semihosting-config, or OpenOCD monitor arm semihosting enable), when the active Target Configuration does not set this itself.

**Registry default:** `false`

## GDB server port

**Key:** `debug.server.port` · **Type:** number

See the owning feature guide for operation prerequisites.

**Registry default:** `3333`

## GDB server startup timeout (ms)

**Key:** `debug.server.startupTimeout` · **Type:** number

See the owning feature guide for operation prerequisites.

**Registry default:** `8000`

## Active core (dual-core targets)

**Key:** `debug.smp.core` · **Type:** select

For dual-core targets (STM32H7 CM7+CM4, RP2040 core0+core1): which of the resolved target's real cores to debug. Resolved against the actual core list probe-rs detected for this chip, not a raw GDB thread number -- has no effect on single-core targets.

**Registry default:** `"primary"`

## Break at entry (main)

**Key:** `debug.stopOnEntry` · **Type:** boolean

Insert a temporary breakpoint on main when the session connects.

**Registry default:** `false`

## SWO TRACECLKIN (Hz, default)

**Key:** `debug.swo.cpuHz` · **Type:** number

Core/trace clock used by OpenOCD tpiu config (e.g. 168000000 for STM32F405 @ 168 MHz), when the active Target Configuration does not set this itself.

**Registry default:** `168000000`

## Enable SWO / ITM (default)

**Key:** `debug.swo.enabled` · **Type:** boolean

Ask OpenOCD to open a SWO TCP port and enable ITM port 0, when the active Target Configuration does not set this itself. Requires a probe that supports SWO (not QEMU).

**Registry default:** `false`

## SWO TCP port

**Key:** `debug.swo.port` · **Type:** number

See the owning feature guide for operation prerequisites.

**Registry default:** `3443`

## Diff editor: ignore whitespace

**Key:** `diffEditor.ignoreTrimWhitespace` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Diff editor: side by side

**Key:** `diffEditor.renderSideBySide` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Accept suggestion on Enter

**Key:** `editor.acceptSuggestionOnEnter` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"smart"`

## Screen reader optimization

**Key:** `editor.accessibilitySupport` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"auto"`

## Auto-close brackets

**Key:** `editor.autoClosingBrackets` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"languageDefined"`

## Auto-close quotes

**Key:** `editor.autoClosingQuotes` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"languageDefined"`

## Bracket pair colorization

**Key:** `editor.bracketPairColorization.enabled` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Cursor animation

**Key:** `editor.cursorBlinking` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"smooth"`

## Detect indentation

**Key:** `editor.detectIndentation` · **Type:** boolean

Guess tab size and insert-spaces from file contents.

**Registry default:** `true`

## Drag and drop selections

**Key:** `editor.dragAndDrop` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Code folding

**Key:** `editor.folding` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Font family

**Key:** `editor.fontFamily` · **Type:** string

See the owning feature guide for operation prerequisites.

**Registry default:** `"JetBrains Mono, Fira Code, monospace"`

## Font ligatures

**Key:** `editor.fontLigatures` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Font size

**Key:** `editor.fontSize` · **Type:** number

See the owning feature guide for operation prerequisites.

**Registry default:** `13`

## Format on paste

**Key:** `editor.formatOnPaste` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Format on save

**Key:** `editor.formatOnSave` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `false`

## Indentation guides

**Key:** `editor.guides.indentation` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Hover delay (ms)

**Key:** `editor.hover.delay` · **Type:** number

See the owning feature guide for operation prerequisites.

**Registry default:** `300`

## Hover tooltips

**Key:** `editor.hover.enabled` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Insert spaces on Tab

**Key:** `editor.insertSpaces` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Line height

**Key:** `editor.lineHeight` · **Type:** number

See the owning feature guide for operation prerequisites.

**Registry default:** `20`

## Linked editing

**Key:** `editor.linkedEditing` · **Type:** boolean

Rename matching HTML/JSX tag pairs together.

**Registry default:** `false`

## Highlight matching brackets

**Key:** `editor.matchBrackets` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"always"`

## Minimap

**Key:** `editor.minimap.enabled` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Zoom with mouse wheel

**Key:** `editor.mouseWheelZoom` · **Type:** boolean

Hold Cmd/Ctrl and scroll to change font size.

**Registry default:** `false`

## Multi-cursor modifier

**Key:** `editor.multiCursorModifier` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"alt"`

## Highlight symbol occurrences

**Key:** `editor.occurrencesHighlight` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Parameter hints

**Key:** `editor.parameterHints.enabled` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Quick suggestions

**Key:** `editor.quickSuggestions` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Highlight current line

**Key:** `editor.renderLineHighlight` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"line"`

## Render whitespace

**Key:** `editor.renderWhitespace` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"none"`

## Rulers

**Key:** `editor.rulers` · **Type:** string

Comma-separated column positions, e.g. 80,120.

**Registry default:** `""`

## Scroll beyond last line

**Key:** `editor.scrollBeyondLastLine` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `false`

## Highlight selection matches

**Key:** `editor.selectionHighlight` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Smooth scrolling

**Key:** `editor.smoothScrolling` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Sticky scroll

**Key:** `editor.stickyScroll.enabled` · **Type:** boolean

Sticky scope headers at the top of the editor.

**Registry default:** `true`

## Tab size

**Key:** `editor.tabSize` · **Type:** number

See the owning feature guide for operation prerequisites.

**Registry default:** `4`

## Trim auto whitespace

**Key:** `editor.trimAutoWhitespace` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Word wrap

**Key:** `editor.wordWrap` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"off"`

## Auto reveal active file

**Key:** `explorer.autoReveal` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Compact folders

**Key:** `explorer.compactFolders` · **Type:** boolean

Render single-child folder chains on one row.

**Registry default:** `true`

## Confirm delete

**Key:** `explorer.confirmDelete` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Confirm drag and drop

**Key:** `explorer.confirmDragAndDrop` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Sort order

**Key:** `explorer.sortOrder` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"default"`

## Auto save

**Key:** `files.autoSave` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"off"`

## Auto save delay (ms)

**Key:** `files.autoSaveDelay` · **Type:** number

See the owning feature guide for operation prerequisites.

**Registry default:** `1000`

## End of line

**Key:** `files.eol` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"auto"`

## Restore unsaved changes between sessions

**Key:** `files.hotExit` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"onExit"`

## Insert final newline on save

**Key:** `files.insertFinalNewline` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `false`

## Max memory for large files (MB)

**Key:** `files.maxMemoryForLargeFilesMB` · **Type:** number

See the owning feature guide for operation prerequisites.

**Registry default:** `4096`

## Restore undo stack on reopen

**Key:** `files.restoreUndoStack` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Save conflict resolution

**Key:** `files.saveConflictResolution` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"askUser"`

## Trim trailing whitespace on save

**Key:** `files.trimTrailingWhitespace` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `false`

## Auto-open serial monitor on flash

**Key:** `firmware.autoOpenSerial` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Preferred debug probe (default)

**Key:** `firmware.board.debugProbe` · **Type:** select

Fallback used when the active Target Configuration does not set its own probe preference.

**Registry default:** `"auto"`

## Board revision (default)

**Key:** `firmware.boardRevision` · **Type:** string

Fallback used when the active Target Configuration does not set its own revision.

**Registry default:** `""`

## Build command (non-CMake projects)

**Key:** `firmware.buildCommand` · **Type:** string

Spawned in the project root when Build runs and no CMakeLists.txt, PlatformIO, or Zephyr project is detected -- a plain Makefile project's real build command.

**Registry default:** `"make"`

## cppcheck path

**Key:** `firmware.cppcheckPath` · **Type:** path

Binary spawned by Run Checks → Static Analysis. Leave as "cppcheck" to auto-detect from PATH/Homebrew, or set a full path.

**Registry default:** `"cppcheck"`

## GDB path

**Key:** `firmware.gdbPath` · **Type:** path

Leave empty to resolve GDB beside the project compiler. An explicit SDK or multiarch debugger must support --interpreter=mi2.

**Registry default:** `""`

## OpenOCD config script

**Key:** `firmware.openocdConfig` · **Type:** string

Passed to OpenOCD via -f, e.g. board/st\_nucleo\_f4.cfg.

**Registry default:** `""`

## OpenOCD path

**Key:** `firmware.openocdPath` · **Type:** path

Binary spawned by Flash.

**Registry default:** `"openocd"`

## probe-rs path

**Key:** `firmware.probeRsPath` · **Type:** path

Binary spawned by the probe-rs Flash/Debug backend and by real chip/probe detection (Project Profile). Leave as "probe-rs" to auto-detect from PATH/cargo, or set a full path.

**Registry default:** `"probe-rs"`

## Serial monitor buffer size (lines)

**Key:** `firmware.serialBufferSize` · **Type:** number

See the owning feature guide for operation prerequisites.

**Registry default:** `20000`

## Target chip

**Key:** `firmware.targetChip` · **Type:** select

Picks the OpenOCD target config for Flash and Debug, and overrides probe-rs chip identity resolution (cores, memory, register map) shown in the Firmware settings tab and Project Profile. Overrides prescaler.json's target.chip when set.

**Registry default:** `""`

## Additional tool directory

**Key:** `firmware.toolchainPath` · **Type:** path

Prepended to PATH for native build commands. Choose the actual compiler in the project toolchain file; supports any vendor SDK.

**Registry default:** `""`

## Adapter speed (kHz)

**Key:** `flash.adapterSpeedKhz` · **Type:** number

See the owning feature guide for operation prerequisites.

**Registry default:** `4000`

## Flash algorithm override

**Key:** `flash.algorithm` · **Type:** string

Leave blank to auto-detect.

**Registry default:** `""`

## Flash backend

**Key:** `flash.backend` · **Type:** select

Programmer used to write firmware. pyOCD covers more Cortex-M/Nordic/RP2040 targets out of the box.

**Registry default:** `"openocd"`

## Hold reset while connecting

**Key:** `flash.connectUnderReset` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `false`

## Erase before flash

**Key:** `flash.eraseBeforeFlash` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"auto"`

## Erase granularity

**Key:** `flash.eraseGranularity` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"sector"`

## Preferred probe (serial/path)

**Key:** `flash.pinnedProbeSerial` · **Type:** string

When more than one debug probe is attached, prefer the one matching this serial/path. Matches pyOCD's --uid / STM32CubeProgrammer's sn= real precedent. Leave blank to auto-select when exactly one probe is connected.

**Registry default:** `""`

## After flashing

**Key:** `flash.resetAfterFlash` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"run"`

## Verify after flashing

**Key:** `flash.verifyAfterFlash` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Auto fetch

**Key:** `git.autofetch` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `false`

## Auto fetch period (s)

**Key:** `git.autofetchPeriod` · **Type:** number

See the owning feature guide for operation prerequisites.

**Registry default:** `180`

## Auto stash before pull

**Key:** `git.autoStash` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `false`

## Protected branches

**Key:** `git.branchProtection` · **Type:** string

Comma-separated; warns before a direct commit.

**Registry default:** `"main,master"`

## Confirm before sync

**Key:** `git.confirmSync` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Git decorations in explorer

**Key:** `git.decorations.enabled` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Smart commit

**Key:** `git.enableSmartCommit` · **Type:** boolean

Commit all staged changes, or all changes if none are staged.

**Registry default:** `true`

## After commit

**Key:** `git.postCommitCommand` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"none"`

## Prune on fetch

**Key:** `git.pruneOnFetch` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `false`

## Pull before checkout

**Key:** `git.pullBeforeCheckout` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `false`

## Rebase instead of merge on sync

**Key:** `git.rebaseWhenSync` · **Type:** boolean

Passes --rebase to git pull instead of the default fast-forward merge.

**Registry default:** `false`

## Notify on push success

**Key:** `git.showPushSuccessNotification` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `false`

## Untracked changes

**Key:** `git.untrackedChanges` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"separate"`

## Measured supply voltage (V)

**Key:** `power.profiler.vddVolts` · **Type:** number

Used to convert measured current into power and energy for this capture.

**Registry default:** `3.3`

## Auto reveal problems panel

**Key:** `problems.autoReveal` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Problem decorations in explorer

**Key:** `problems.decorations.enabled` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Problem counts in status bar

**Key:** `problems.showCurrentInStatus` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Problems sort order

**Key:** `problems.sortOrder` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"severity"`

## Startup workspace

**Key:** `profile.startupWorkspace` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"last"`

## Block flash on board revision mismatch

**Key:** `release.blockIncompatibleFlash` · **Type:** boolean

When release.json declares compatible board revisions, refuse to flash a mismatched board revision.

**Registry default:** `true`

## Default minimum bootloader version

**Key:** `release.defaultMinBootloaderVersion` · **Type:** string

Prefills the Create manifest form in the Release panel.

**Registry default:** `"1.0.0"`

## Warn when release.json is missing

**Key:** `release.warnOnMissingManifest` · **Type:** boolean

Surface a Release panel reminder when the project has no release manifest yet.

**Registry default:** `true`

## Diff decorations in gutter

**Key:** `scm.diffDecorationsGutterVisibility` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"always"`

## Collapse results

**Key:** `search.collapseResults` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"auto"`

## Follow symlinks

**Key:** `search.followSymlinks` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Max results

**Key:** `search.maxResults` · **Type:** number

See the owning feature guide for operation prerequisites.

**Registry default:** `200`

## Search as you type

**Key:** `search.searchOnType` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Search-on-type debounce (ms)

**Key:** `search.searchOnTypeDebouncePeriod` · **Type:** number

See the owning feature guide for operation prerequisites.

**Registry default:** `300`

## Show line numbers in results

**Key:** `search.showLineNumbers` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `false`

## Smart case

**Key:** `search.smartCase` · **Type:** boolean

Case-insensitive unless the pattern has an uppercase letter.

**Registry default:** `false`

## Respect .gitignore

**Key:** `search.useIgnoreFiles` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Preview before replace

**Key:** `search.useReplacePreview` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Use ripgrep when available

**Key:** `search.useRipgrep` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Workspace trust prompts

**Key:** `security.workspace.trust.enabled` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Untrusted files

**Key:** `security.workspace.trust.untrustedFiles` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"prompt"`

## Auto-connect on matching device

**Key:** `serial.autoConnect` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `false`

## Auto-reconnect if port drops

**Key:** `serial.autoReconnect` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Default baud rate

**Key:** `serial.defaultBaud` · **Type:** number

See the owning feature guide for operation prerequisites.

**Registry default:** `115200`

## Flow control

**Key:** `serial.flowControl` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"none"`

## Show incoming data as hex

**Key:** `serial.hexView` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `false`

## Line ending appended when sending

**Key:** `serial.lineEnding` · **Type:** select

Appended to whatever you type before it's written to the port. Matches PlatformIO's monitor\_eol / Arduino's send-line-ending selector.

**Registry default:** `"\n"`

## Local echo

**Key:** `serial.localEcho` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `false`

## Mirror output to a log file

**Key:** `serial.logToFile` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `false`

## Parity

**Key:** `serial.parity` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"none"`

## Show timestamps

**Key:** `serial.showTimestamps` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `false`

## Bell style

**Key:** `terminal.integrated.bellStyle` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"none"`

## Confirm on exit with active process

**Key:** `terminal.integrated.confirmOnExit` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `false`

## Copy on selection

**Key:** `terminal.integrated.copyOnSelection` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `false`

## Cursor blinking

**Key:** `terminal.integrated.cursorBlinking` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Cursor style

**Key:** `terminal.integrated.cursorStyle` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"bar"`

## Font family

**Key:** `terminal.integrated.fontFamily` · **Type:** string

See the owning feature guide for operation prerequisites.

**Registry default:** `"JetBrains Mono, Fira Code, monospace"`

## Font size

**Key:** `terminal.integrated.fontSize` · **Type:** number

See the owning feature guide for operation prerequisites.

**Registry default:** `13`

## Initial columns

**Key:** `terminal.integrated.initialCols` · **Type:** number

See the owning feature guide for operation prerequisites.

**Registry default:** `120`

## Initial rows

**Key:** `terminal.integrated.initialRows` · **Type:** number

See the owning feature guide for operation prerequisites.

**Registry default:** `24`

## Line height

**Key:** `terminal.integrated.lineHeight` · **Type:** number

See the owning feature guide for operation prerequisites.

**Registry default:** `1.2`

## Zoom with mouse wheel

**Key:** `terminal.integrated.mouseWheelZoom` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `false`

## Retained output (bytes)

**Key:** `terminal.integrated.outputBufferBytes` · **Type:** number

Output retained for terminal tabs while their panes are hidden.

**Registry default:** `1048576`

## Right-click behavior

**Key:** `terminal.integrated.rightClickBehavior` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"copyPaste"`

## Scrollback lines

**Key:** `terminal.integrated.scrollback` · **Type:** number

See the owning feature guide for operation prerequisites.

**Registry default:** `10000`

## Shell integration

**Key:** `terminal.integrated.shellIntegration.enabled` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Smooth scrolling

**Key:** `terminal.integrated.smoothScrolling` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Terminal tabs

**Key:** `terminal.integrated.tabs.enabled` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Word separators

**Key:** `terminal.integrated.wordSeparators` · **Type:** string

Characters treated as word boundaries on double-click.

**Registry default:** `" ()[]&#123;&#125;',\"`"\`

## Shell path override

**Key:** `terminal.shellPathOverride` · **Type:** string

Leave blank to use \$SHELL.

**Registry default:** `""`

## Automatic updates

**Key:** `update.mode` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"default"`

## Confirm before closing window

**Key:** `window.confirmBeforeClose` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"never"`

## Restore windows on startup

**Key:** `window.restoreWindows` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"preserve"`

## Title bar style

**Key:** `window.titleBarStyle` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"custom"`

## Zoom level

**Key:** `window.zoomLevel` · **Type:** number

Window zoom, -5 to 5.

**Registry default:** `0`

## Command palette history size

**Key:** `workbench.commandPalette.history` · **Type:** number

See the owning feature guide for operation prerequisites.

**Registry default:** `50`

## Preview tabs

**Key:** `workbench.editor.enablePreview` · **Type:** boolean

Single click opens a file in a reusable preview tab.

**Registry default:** `true`

## Max open editors

**Key:** `workbench.editor.limit.value` · **Type:** number

0 = no limit.

**Registry default:** `10`

## Editor tabs

**Key:** `workbench.editor.showTabs` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"multiple"`

## Tab close button position

**Key:** `workbench.editor.tabCloseButton` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"right"`

## Tab sizing

**Key:** `workbench.editor.tabSizing` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"fit"`

## File icon theme

**Key:** `workbench.iconTheme` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"prescaler-icons"`

## Smooth scrolling in lists

**Key:** `workbench.list.smoothScrolling` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Default panel location

**Key:** `workbench.panel.defaultLocation` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"bottom"`

## Side bar location

**Key:** `workbench.sideBar.location` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"left"`

## On project open

**Key:** `workbench.startupEditor` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"welcomePage"`

## Status bar visible

**Key:** `workbench.statusBar.visible` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Tree indent (px)

**Key:** `workbench.tree.indent` · **Type:** number

See the owning feature guide for operation prerequisites.

**Registry default:** `16`

## Tree indent guides

**Key:** `workbench.tree.renderIndentGuides` · **Type:** select

See the owning feature guide for operation prerequisites.

**Registry default:** `"onHover"`

## Zen mode: center layout

**Key:** `zenMode.centerLayout` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`

## Zen mode: hide line numbers

**Key:** `zenMode.hideLineNumbers` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `false`

## Zen mode: silence notifications

**Key:** `zenMode.silentNotifications` · **Type:** boolean

See the owning feature guide for operation prerequisites.

**Registry default:** `true`