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.

Agents

Controls over agent autonomy:

• Auto-approve — which actions the agent can take without asking the user (read files, edit files, run commands, etc.). See Auto-approve for details.
• Autopilot — full autonomous mode for the agent.
• Browser preview — whether Code and Debug agents can drive the Integrated Browser through preview (kodik.preview.enabled, default: true).
• 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.
• Summarization triggers — when the agent should compact long conversations.
• Sub-agent model — the model used by the internal sub-agent.

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.
• 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.
• Delete index — fully clear the local index.
• Pause — 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 in .kodik/index (SQLite). 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 trailer to commits the agent creates (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.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).

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. The built-in research agent is always available; plugin-provided agents appear here once their plugin is installed and enabled.

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

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 preview tool is withheld from Code and Debug sessions.