Mark IJbema
f290cb0af3
Updates documentation to reflect the UI changes from PR #5264: - 'Modes' settings tab renamed to 'Agent Behaviour' - Four sub-tabs: Modes, MCP Servers, Rules, Workflows - MCP Servers no longer in top bar - Updated navigation instructions throughout docs
2.6 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:
1. **Open Agent Behaviour Tab:** Click the icon in the Kilo Code top menu bar to open Settings, then select the `Agent Behaviour` tab
2. **Select Modes Sub-Tab:** Click on the `Modes` sub-tab
3. **Find Section:** Find the "Custom Instructions for All Modes" section
4. **Enter Instructions:** Enter your instructions in the text area
5. **Save Changes:** Click "Done" to save your changes
Mode-Specific Instructions
Mode-specific instructions can be set using the Agent Behaviour tab
<img src="/docs/img/custom-instructions/custom-instructions-3.png" alt="Kilo Code Agent Behaviour tab showing mode-specific custom instructions interface" width="600" />
* **Open Agent Behaviour Tab:** Click the <Codicon name="gear" /> icon in the Kilo Code top menu bar to open Settings, then select the `Agent Behaviour` tab
* **Select Modes Sub-Tab:** Click on the `Modes` sub-tab
* **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.
:::