Search Documentation

Find and navigate to documentation pages and their content

Settings Reference

Complete guide to configuring Codistry for your workflow.

Most settings live in the UI

You almost never need to touch a config file. Open the Codistry sidebar in VS Code and click the settings gearat the top, the Settings view groups everything below into tabs (Models, Context Engine, Tools & Integrations, and more) with friendly toggles and inputs.

The keys documented here are the same ones the UI writes for you, so this page doubles as a reference for what each control does.

Prefer editing config directly? Open the gear from the Command Palette (Codistry: Open Settings), or edit settings.json via Preferences: Open User Settings (JSON). Every key below is prefixed with adronite-agent. in settings.json (e.g. adronite-agent.maxIterations).

Provider Configuration

SettingDefaultWhat it does
modelProvideranthropicWhich provider powers requests: anthropic · openai · custom-openai (local / corporate / OpenAI-compatible).
openaiApiUrl""Custom OpenAI-compatible endpoint (e.g. Ollama :11434/v1, LM Studio :1234/v1). Empty uses api.openai.com.
anthropicApiUrl""Custom Anthropic endpoint for proxies, regional gateways, or Bedrock. Usually left empty.
reasoningEffortmediumThinking depth for reasoning models: none · minimal · low · medium · high · xhigh. Higher = slower and pricier.

adronite-agent.model

The default model every new chat session starts with (within the selected provider). Switching the model inside a chat overrides it for that session only; this default is left untouched.

Typestring
Defaultclaude-sonnet-4-6
TaskModelWhy
Refactoringclaude-opus-4, gpt-5Deep code understanding
Quick Editsclaude-sonnet-4-6, gpt-5.2Fast and accurate
Complex Problemso1, o3Advanced reasoning
Privacy/Offlinellama3-70bNo external calls

This is a new-session default: each new chat opens with this model. Use the model picker in the chat header to switch the model for a single session. That choice is saved with the session and doesn't change this default or affect chats you've already started. See Models → Default model.

Model Management

adronite-agent.customModels

Define custom models for local LLMs, corporate endpoints, or specialized deployments.

Typearray of model objects
Default[]

Add and edit models in Settings → Models → Add Custom Model. Each model offers:

  • Basics: display name, model name, API URL, and an optional per-model API key
  • Token limits: Max Tokens and Max Output Tokens
  • Capabilities: reasoning, images, temperature, and streaming toggles
  • Advanced Settings: sampling parameters (temperature, top-p, top-k, min-p, and repetition / frequency / presence penalties) and a reasoning/thinking format for open models

Tool support is required. Codistry only works with models that support tool/function calling, so there is no toggle to turn it off.

SettingDefaultWhat it does
disabledProviders{}Hide specific providers from the UI (e.g. enforce corporate policy).
streamingEnabledall trueReal-time token streaming per provider. Disable for local models with buggy streaming.

Behavior & Control

adronite-agent.globalAutoApprove

Skip ALL tool approval prompts automatically.

Typeboolean
Defaultfalse

⚠️ Use with extreme caution

The agent can modify files and run commands without permission. Never enable for production code. Use autoApproveTools for granular control instead.

adronite-agent.autoApproveTools

Granular auto-approval for specific tools by name.

Typeobject (tool → boolean)
Default{} (no auto-approvals)

🟢 Safe

read_file, find_files_by_name, grep_file_contents, list_symbols_in_file, get_file_diagnostics, get_git_status

🟡 Caution

edit_file, write_file, memory.*

🔴 Dangerous

run_shell_command, run_vscode_editor_command, run_vscode_task, rename_symbol_across_codebase

{
  "adronite-agent.autoApproveTools": {
    "read_file": true,
    "find_files_by_name": true,
    "grep_file_contents": true,
    "list_symbols_in_file": true,
    "get_file_diagnostics": true,
    "get_git_status": true,
    "edit_file": false,
    "run_shell_command": false
  }
}

adronite-agent.autoApproveCommands

Terminal command allow-patterns (token-prefix) that run without an approval dialog.

Typearray of strings
Default[] (nothing auto-approved)

A run_shell_command invocation that cleanly matches one of these prefixes runs without prompting. Commands containing shell control characters (;, &, |, backticks, $(), redirects) never auto-approve.

{
  "adronite-agent.autoApproveCommands": ["npm test", "git status", "ls"]
}

adronite-agent.denyCommands

Terminal command deny-patterns (token-prefix) that are refused outright, no dialog.

Typearray of strings
Default[]

Deny rules are absolute: they beat every auto-approve grant and apply inside compound commands too.

{
  "adronite-agent.denyCommands": ["rm -rf", "git push --force"]
}
SettingDefaultWhat it does
maxIterations1000Max tool-call steps before the agent stops (1–1000). Lower it for quick, read-only tasks.
autoApproveMcpToolsfalseAuto-approve MCP tool calls — globally, or per server via autoApproveMcpServers.
subagentsEnabledtrueLet the agent delegate focused sub-tasks to isolated agents. A built-in general-purpose agent is always available. See Agents & Subagents.

Context & Memory

SettingDefaultWhat it does
contextRules""Custom instructions added to every request (style, frameworks, testing). Keep to ~100–300 words.
projectMemorytrueBuild a persistent, local knowledge graph about your codebase for better context in later sessions.
enableSummarizationtrueSummarize older turns to preserve context. Off = sliding window that drops the oldest messages.
enableAdaptiveLearningtrueLearn cross-project preferences (tone, standards, common corrections). Stored locally only.
adaptiveLearningContent""The learned worldview text. Auto-populated; edit it to curate what the agent remembers.

Context Engine

adronite-agent.contextEngineEnabled

Umbrella toggle for the Adronite Context Engine: concept-graph tools, the Index settings tab, and the knowledge-graph subsystem.

Typeboolean
Defaulttrue

One switch controls the whole engine: when on, the agent can pull in relevant context automatically, the Context Engine settings tab is active, and the code-navigation tools are enabled.

SettingDefaultWhat it does
conceptSearch2EnabledfalseConcept-graph search over files edited together in the same commits (developer preview).
conceptSearchEmbedderlocalEmbedding provider for the concept index: local · auto · openai · openrouter.
contextPackAutoInjecttrueSeed each fresh task with likely-relevant file paths (references only). A no-op without an index.
contextPackBudget8000Token budget for the on-demand context pack (1000–32000). Doesn't affect the auto-inject seed.
contextPackCoChangetrueAlso surface frequently co-edited supporting files (a git-history signal). Additive only.
contextIndexAutoUpdatetrueRefresh existing indexes when git HEAD changes. Never builds from scratch.
contextIndexNotifyOnCommittrueWhen auto-update is off, prompt to refresh after a commit.
contextIndexModeldefault modelPick a specific (e.g. cheaper) model to build indexes instead of your chat model.
fileBriefEnabledfalseLet the agent get a deterministic outline of a large file without reading it in full.

Advanced

adronite-agent.mcpLazyLoading

"Skinny Tools": make tool usage more token-efficient.

Typeboolean
Defaulttrue

Shown as Skinny Tools under Tools & Integrations. When on, the agent loads the full details of a tool only when it needs it, which can cut token usage significantly. Leave it on unless you notice the agent struggling to pick the right tool.

adronite-agent.skillsEnabled

Enable the Skills system for isolated Docker execution.

Typeboolean
Defaulttrue
RequiresDocker
  • skillsDirectory: default ~/.adronite/skills
  • skillsDockerImage: default adronite/adronite-skills:latest
  • dynamicSkillsEnabled: default true; auto-captures repo-specific procedures as skills in .codistry/skills/

adronite-agent.telemetryEnabled

Anonymous usage data for improving the extension.

Typeboolean
Defaulttrue

Collected (anonymous)

  • Feature usage patterns
  • Performance metrics
  • Error reports (no code)

Never collected

  • Source code or file contents
  • Prompts or conversations
  • API keys or credentials

Respects VS Code's global telemetry setting.

SettingDefaultWhat it does
mcpEnabledtrueEnable Model Context Protocol servers. Disable for air-gapped or locked-down setups. See the MCP Extensions guide.
showSidebarOnLaunchtrueOpen and focus the Codistry sidebar when VS Code starts.

Account & License

The Account section in Settings shows:

  • Email, Licensed badge, active session status
  • License token validity and expiration
  • Active plan and next renewal date
  • Manage Subscription: opens your billing portal

The Developer tier is free, no subscription required when using your own API keys.

Configuration Examples

Local Development (Privacy-First)

{
  "adronite-agent.modelProvider": "custom-openai",
  "adronite-agent.model": "llama3-70b",
  "adronite-agent.openaiApiUrl": "http://localhost:11434/v1",
  "adronite-agent.autoApproveTools": {
    "read_file": true,
    "find_files_by_name": true,
    "list_symbols_in_file": true
  }
}

Enterprise / Corporate

{
  "adronite-agent.modelProvider": "openai",
  "adronite-agent.model": "gpt-5.2",
  "adronite-agent.openaiApiUrl": "https://ai.mycompany.com/v1",
  "adronite-agent.maxIterations": 20,
  "adronite-agent.autoApproveTools": {},
  "adronite-agent.telemetryEnabled": false,
  "adronite-agent.contextRules": "Follow company security guidelines."
}

Maximum Privacy

{
  "adronite-agent.modelProvider": "custom-openai",
  "adronite-agent.openaiApiUrl": "http://localhost:11434/v1",
  "adronite-agent.telemetryEnabled": false,
  "adronite-agent.mcpEnabled": false,
  "adronite-agent.skillsEnabled": false,
  "adronite-agent.enableAdaptiveLearning": false
}
What's Next?

Check out Best Practices for optimization tips or the FAQ for common questions.