Files
Kilo-Org_kilo/packages/kilo-docs/docs/advanced-usage/custom-instructions.md
T
Kevin van Dijk 19a52a262f Add 'apps/kilocode-docs/' from commit '79ed21f1913d5d8426c39e7ecf19907a1a2913e1'
git-subtree-dir: apps/kilocode-docs
git-subtree-mainline: 0ab87945123cba85a6e76ca5a7f427197b7e1f77
git-subtree-split: 79ed21f1913d5d8426c39e7ecf19907a1a2913e1
2025-08-27 17:18:50 +02:00

2.3 KiB

Custom Instructions

Custom Instructions allow you to personalize how Kilo Code behaves, providing specific guidance that shapes responses, coding style, and decision-making processes.

What Are Custom Instructions?

Custom Instructions define specific Extension behaviors, preferences, and constraints beyond Kilo's basic role definition. Examples include coding style, documentation standards, testing requirements, and workflow guidelines.

:::info Custom Instructions vs Rules Custom Instructions are IDE-wide and are applied across all workspaces and maintain your preferences regardless of which project you're working on. Unlike Instructions, Custom Rules are project specific and allow you to setup workspace-based ruleset. :::

Setting Custom Instructions

How to set them:

Kilo Code Modes tab showing global custom instructions interface 1. **Open Modes Tab:** Click the icon in the Kilo Code top menu bar 2. **Find Section:** Find the "Custom Instructions for All Modes" section 3. **Enter Instructions:** Enter your instructions in the text area 4. **Save Changes:** Click "Done" to save your changes

Mode-Specific Instructions

Mode-specific instructions can be set using the Modes Tab

<img src="/docs/img/custom-instructions/custom-instructions-3.png" alt="Kilo Code Modes tab showing mode-specific custom instructions interface" width="600" />
* **Open Tab:** Click the <Codicon name="organization" /> icon in the Kilo Code top menu bar
* **Select Mode:** Under the Modes heading, click the button for the mode you want to customize
* **Enter Instructions:** Enter your instructions in the text area under "Mode-specific Custom Instructions (optional)"
* **Save Changes:** Click "Done" to save your changes

    :::info Global Mode Rules
    If the mode itself is global (not workspace-specific), any custom instructions you set for it will also apply globally for that mode across all workspaces.
    :::