Skip to content
Nx IDEDocs

Customization6 min read

Settings & Feature Flags

The settings surface and Nexgile feature toggles

Everything tunable in Nexgile Code lives in one Settings view, opened from the gear icon in the panel’s toolbar. This page tours the sections, then goes deep on the Agent Workflow feature toggles — the switches that shape what you see around a task — plus the experimental flags, notifications, and settings portability.

Most sections stage changes until you click Save at the top of the view; unsaved edits are flagged if you try to navigate away.

The sections

Section titled “The sections”
Section What you configure there
Providers API configuration profiles: provider, key, model, temperature, reasoning effort. See Providers Overview.
Modes Built-in and custom modes; create/edit/delete, import/export, per-mode model pinning. See Custom Modes.
Skills Create and manage on-demand instruction packages. See Skills.
Slash Commands Create, edit, and delete project/global commands. See Slash Commands.
Auto-Approve The master toggle and every per-category auto-approval, plus request/cost caps. See Auto-Approving Actions.
MCP Servers Server list, per-server tools and logs, config file access. See Configuring MCP Servers.
Checkpoints Shadow-repository versioning of agent changes. See Checkpoints.
Notifications Text-to-speech and sound effects (below).
Context Auto-condense threshold, open-tab/workspace-file caps, diagnostics limits, Enable subfolder rules. See Context Management.
Terminal Shell integration, timeouts, output preview size. See Terminal & Shell Integration.
Prompts Support prompts (enhance, explain, etc.) and global custom instructions.
Worktrees Git worktree creation/switching for parallel branch work. See Worktrees.
UI Language preference for agent communication (18 options) and interface preferences.
Agent Workflow Workflow Mode plus the feature toggles below.
Experimental The four experimental flags (below).
About Version info, settings import/export/reset, telemetry preferences.

Agent Workflow: Workflow Mode

Section titled “Agent Workflow: Workflow Mode”

The Agent Workflow section leads with the Workflow Mode checkbox (off by default). When on, new top-level tasks started in Code or Debug mode are automatically routed through the multi-agent delivery chain — Implementer → Tester → Reviewer → Shipper — at roughly 3–4× the cost and latency of a direct run, in exchange for independent verification. Other modes run directly. Full treatment in Workflow Mode.

Agent Workflow: feature toggles

Section titled “Agent Workflow: feature toggles”

Below it sit eight product-feature toggles. They’re stored in the panel’s local UI state on this machine (not in your exportable settings file) and apply when you click Save:

Toggle Default What it does
Task Board Off Interactive task panel for managing user-defined and agent-derived tasks.
Task Progress Bar Off Phase-based progress indicator across a task (Plan → Read → Edit → Verify → Done).
Pipeline View On A Plan → Code → Review → Test strip above the conversation. The stages are inferred from what the task actually does — reasoning starts Plan, the first file edit starts Code, file reads mark Review, command runs mark Test — so it appears on ordinary tasks, not only Workflow Mode ones. Each stage shows pending, active, done, or (once the task completes without ever reaching it) skipped, with elapsed time.
Code Review Gate On Post-task lint, type-check, and AI self-review on changed files.
Test Runner On Automated test detection and execution for changed files after task completion.
Visual Preview Off Open-in-browser button for visually verifying UI changes. Enabling it reveals a Preview URL field (default http://localhost:3000) — point it at your dev server.
Task Templates On Pre-built workflow templates: Feature, Bug Fix, Refactor, Security Audit.
Task Dashboard On Productivity metrics on the panel’s home screen: task count, cost, tokens, and a daily activity chart. Appears once you have at least three tasks in history — before that there is nothing to chart.

Post-task verification

Section titled “Post-task verification”

Code Review Gate and Test Runner share one behavior worth understanding: when a task completes with changed files and either toggle is on, Nexgile Code automatically sends one follow-up message in the same conversation asking the agent to (a) re-review its changes against the original request and fix real issues it finds, and (b) run the build and the tests related to changed files, fixing failures. It fires at most once per task — the agent’s response to the verification pass doesn’t trigger another — and is skipped when nothing changed. It’s a cheap second look that catches a surprising number of “done but not quite” completions. For heavier verification with an independent tester and reviewer, use Workflow Mode.

Experimental flags

Section titled “Experimental flags”

Settings → Experimental holds four flags, all off by default:

Flag What it enables
Prevent Focus Disruption (preventFocusDisruption) Background editing — the agent edits files without opening them in the editor or stealing your focus while you work.
Image Generation (imageGeneration) Adds the generate_image tool so the agent can create/edit images in tasks.
Run Slash Command (runSlashCommand) Lets the agent invoke your slash commands mid-task via the run_slash_command tool (each use still prompts).
Custom Tools (customTools) Loads user-defined tools from .nexgile/tools/ (project) and ~/.nexgile/tools/ (global).

Experimental means exactly that: behavior may change, and they default off for a reason. Enable one at a time so you can attribute surprises.

Notifications

Section titled “Notifications”

Settings → Notifications offers two channels, both off by default:

  • Text-to-speech (ttsEnabled) — speaks agent responses aloud; ttsSpeed controls the rate (default 1×). Useful when a long task runs while you’re across the room.
  • Sound effects (soundEnabled) — plays audio cues for events like approvals needed and task completion; soundVolume defaults to 0.5.

If approval prompts are what’s interrupting you, the fix is usually auto-approve tuning rather than louder notifications.

Import, export, and storage

Section titled “Import, export, and storage”
  • Export / Import / Reset — from the About section (also available as the Import Settings command), export your configuration — provider profiles, global settings, and global custom modes — to a JSON file, and import it on another machine. Invalid or since-removed providers in an imported file are sanitized with a warning rather than failing the whole import. Reset returns everything to defaults.
  • Auto-import on startup — set nexgile-code.autoImportSettingsPath (editor setting) to a settings-file path and a fresh installation configures itself from it on first launch. Ideal for team onboarding images.
  • Custom storage path — nexgile-code.customStoragePath relocates Nexgile Code’s data directory (task history, settings) — for example onto a bigger drive. Leave empty for the default location.
Section titled “Related”