Settings

Kodik settings live in two places:

• Kodik’s built-in Settings editor — most options: profile, agents, autocomplete, models, indexing, MCP, anonymizer, and more.
• settings.json (standard VS Code settings) — a handful of specialized parameters described at the end of this page.

Opening settings

Click the gear Settings button in the title bar and pick Kodik Settings — the same menu also gives you the editor settings, manage actions (Command Palette, Keyboard Shortcuts, and so on), and GitHub sign-in. Alternatively, run the kodik.openSettings command. When the Settings editor is active, press Ctrl+F to move focus to the search bar, which filters sections and settings in real time.

Settings sections

Account

The signed-in user’s profile, current plan and its status, credit balance, usage history broken down by model and session, trial information, daily free credit claim, and the referral program. See Account & usage for details.

General

General Kodik behavior:

• Interface language — UI language (invokes the standard VS Code locale command). Russian is built into the application and used by default; the chosen language applies after a restart.
• AI response language — the default language the AI assistant replies in.
• Notifications — enable and configure system notifications.
• Reset to defaults — resets all Kodik settings to their default values.

Harness

The single user-facing policy for what Kodik sends to the model. Pick Plan, Code, Ask, Debug, or Educator, then use the one switch on each visible tool to change only that mode. Harness shows only structurally supported tools and summarizes the rest as not offered. Tool action accordions are read-only: they explain the effective schema and hard mode restrictions without adding separate action switches.

The live budget combines active tool-schema and system-prompt tokens and shows how much the selected mode saves versus its default. Disabling every tool, Generate plans in Plan mode, or Protected content guidance is allowed; Harness applies the choice immediately and shows an inline warning.

System-prompt rows expand to the exact resolved text sent on the next turn. Optional sections are mode-scoped. Agents rules, user rules, memory, skills, sub-agent profiles, MCP servers, and optional Environment values also have per-source checkboxes; these suppress prompt text without disabling or deleting the source feature. Working directory and Shell stay required.

Connected MCP tools appear after built-ins in the same list with one mode switch, a server marker, schema-token estimate, and Manage MCP link. MCP Settings still owns setup, authentication, server state, and MCP-owned tool configuration.

Agents

Agent tools and behavior:

• Tools — a link to Harness, the single owner of the model-visible tool set and prompt policy. Agents keeps assistant behavior, file-change display, summarization, and the sub-agent model settings.
• Follow-up suggestions — whether Kodik suggests a likely next message after the assistant replies.
• File change display — whether edited files, including notebooks, open in the editor and whether file changes expand by default.
• Summarization triggers — when the agent should compact long conversations.
• Session memory — whether the memory tool can save temporary task notes inside the current chat session and include them after compaction.
• Sub-agent model — the model used by the internal sub-agent.

Auto Approve

When the agent can act without asking:

• Auto-approve — the main switch and per-tool permissions for actions the agent can run without explicit approval. Auto-approve controls for disabled tools are inactive. See Auto-approve.
• Autopilot — full autonomous mode for the agent.
• Blocked commands — a list of command patterns the agent will never execute (for example, rm *, sudo rm *, git clean*).
• Command patterns — custom patterns for auto-allowing specific commands.

Autocomplete

Inline completion settings:

• Enable autocomplete — global on/off switch.
• Debounce delay — how long to wait after typing stops before sending a request.
• Model source — which model powers autocomplete: the Kodik default, a local Ollama model, or one of your custom (bring-your-own-key) providers.
• Ignored files — glob patterns for files where autocomplete is suppressed.
• Completions in imports and strings — enable suggestions inside import statements and string literals.

The kodik.autocompleteDisableLineRegex and kodik.autocompleteDisableFileRegex parameters (see the settings.json section below) provide fine-grained control via regular expressions. See Autocomplete for more detail.

Models

Manage available models:

• Enable / disable models — control which Kodik cloud models appear in the model picker.
• Summarization threshold — the context length at which automatic conversation compaction is triggered.

Indexing

Codebase indexing controls:

• Sync — start or restart indexing. If indexing is paused, Sync resumes it and runs a fresh reconcile.
• Delete index — fully clear the local index and stop indexing until you run Sync again.
• Pause — cancel the current indexing run and temporarily suspend automatic sync.
• Ignore .gitignore — do not exclude paths listed in .gitignore.
• Ignore .kodikignore — do not exclude paths listed in .kodikignore.

The index is stored locally as SQLite in Kodik user-data workspace storage, outside the project folder. See Codebase indexing for more detail.

Ollama

Manage the local Ollama endpoint:

• Installation and running status.
• Connectivity check for the local server.
• Model selection for use in the agent.
• Download recommended models (Gemma 4 E4B, Qwen3 8B, Devstral 24B, Qwen3 Coder 30B, and others).

See Local models for more detail.

Git

Commit message generation and Git behavior:

• Commit message prompt — extra instructions appended to the built-in commit message prompt (kodik.commitMessage.instructions).
• Pull request instructions — additions to the PR title and description generation prompt (kodik.pullRequest.instructions).
• Commit attribution — whether to add a Kodik Co-authored-by trailer to commits the agent creates and to every commit made from Source Control (kodik.git.commitAttribution).
• PR attribution — whether to mark agent-created pull requests as made with Kodik (kodik.git.prAttribution).
• Branch prefix — prefix for new branches the agent creates; defaults to kodik/ when left empty. Kodik accepts Git-ref-style prefixes and falls back to kodik/ for unsupported values (kodik.git.branchPrefix).
• Auto-delete worktrees — automatically delete old agent worktrees (kodik.git.autoDeleteWorktrees, default: true).
• Worktree keep limit — how many worktrees to keep before pruning older ones (kodik.git.worktreeKeepLimit, default: 15).
• Source-control status — show a live source-control summary (branch, ahead/behind, uncommitted changes, open pull request, CI, conflicts) in the chat footer. It refreshes on repository changes, when the window regains focus, and from the footer’s Refresh action; branch switching rejects unsupported branch names before running git (kodik.git.statusAutoRefresh, default: true).
• Source-control refresh interval — how often, in milliseconds, to refresh the GitHub portion (pull request and CI) while a pull request is open (kodik.git.statusRefreshIntervalMs, default: 300000).

See AI commit messages for more detail.

Anonymizer

Sensitive data protection settings:

• Enable anonymizer — activate masking of sensitive content before it is sent to the model.
• Sensitive file list — view and remove manually marked sensitive regions.

See Anonymizer for more detail.

Skills

List of installed skills discovered from the global and workspace skill directories. Individual skills can be enabled or disabled here.

Commands

List of installed custom slash-commands discovered from supported workspace command directories.

Rules

List of installed rules files discovered from the global and workspace rules directories. Individual files can be enabled or disabled here.

Sub Agents

List of specialized agents the main assistant can delegate tasks to via the sub_agent tool. Built-in agents are always available; enabled project profiles from .kodik/agents/, personal profiles from ~/.kodik/Agents/, and plugin-provided profiles are offered to the model here.

Hooks

Hooks are shell commands that run at key points in the AI coding workflow: tool calls, prompt submissions, session start and stop, and more. Hooks can block, modify, or simply observe what happens.

Memory

View and manage long-term memories Kodik has saved for the current workspace and globally. Secrets are automatically stripped from memory content before it is persisted. See Memory for more detail.

MCP Servers

List of installed MCP servers with options to enable, disable, or remove them. See the MCP section for more detail.

---

settings.json reference

The following parameters are set in settings.json, not in the built-in editor.

Autocomplete

Setting	Type	Default	Description
kodik.autocompleteDisableLineRegex	string[]	[]	Array of regular expressions. If the text of a line up to the cursor matches any pattern, autocomplete is suppressed on that line.
kodik.autocompleteDisableFileRegex	string[]	[]	Array of regular expressions. If the file path matches any pattern, autocomplete is suppressed in that file.

Project documentation (AGENTS.md)

Setting	Type	Default	Description
kodik.project_doc_max_bytes	number	32768	Maximum total bytes of AGENTS.md instruction files to load. Set to 0 to disable AGENTS.md discovery entirely.
kodik.project_doc_fallback_filenames	string[]	[]	Additional instruction filenames checked in each directory when AGENTS.md is absent. AGENTS.override.md and AGENTS.md always take precedence.
kodik.project_root_markers	string[]	[".git"]	Marker filenames used to find the project root when searching for AGENTS.md. An empty list limits the search to the current working directory.

Commit messages and Git

Setting	Type	Default	Description
kodik.commitMessage.instructions	string	""	Extra guidance appended to the built-in commit message generation prompt. Supports the {language} token.
kodik.pullRequest.instructions	string	""	Extra guidance for pull request title and description generation.
kodik.git.commitAttribution	boolean	false	Add a Kodik attribution trailer to commits the agent creates and to every Source Control commit.
kodik.git.prAttribution	boolean	false	Mark pull requests created by the agent as made with Kodik.
kodik.git.branchPrefix	string	""	Prefix for new branches the agent creates. Defaults to kodik/ when left empty or unsupported.
kodik.git.autoDeleteWorktrees	boolean	true	Automatically delete old agent worktrees.
kodik.git.worktreeKeepLimit	number	15	Number of agent worktrees to keep before older ones are pruned automatically. Minimum: 1.
kodik.git.statusAutoRefresh	boolean	true	Show a live source-control status summary in the chat input (branch, ahead/behind, changes, PR, CI, conflicts).
kodik.git.statusRefreshIntervalMs	number	300000	How often (ms) to refresh the GitHub portion of the status while a pull request is open. Minimum: 60000.

See AI commit messages for more detail.

Browser preview

Setting	Type	Default	Description
kodik.preview.enabled	boolean	true	Allow the agent to drive the Integrated Browser. When disabled, the browser tool is withheld from Code and Debug sessions.