docs: restructure documentation and add codebase indexing feature

docs/advanced-usage/available-tools/codebase-search.md

@@ -1,7 +1,7 @@
 # codebase_search
 
 :::warning Experimental Feature
-The `codebase_search` tool is part of the experimental [Codebase Indexing](/features/experimental/codebase-indexing) feature. This feature is under active development and may change significantly in future releases. It requires additional setup including an embedding provider and vector database.
+The `codebase_search` tool is part of the experimental [Codebase Indexing](/features/codebase-indexing) feature. This feature is under active development and may change significantly in future releases. It requires additional setup including an embedding provider and vector database.
 :::
 
 The `codebase_search` tool performs semantic searches across your entire codebase using AI embeddings. Unlike traditional text-based search, it understands the meaning of your queries and finds relevant code even when exact keywords don't match.

docs/advanced-usage/rate-limits-costs.md

@@ -46,6 +46,6 @@ If you set the rate limit to 10 seconds, Kilo Code will wait at least 10 seconds
 *   **Use Custom Instructions:**  Provide custom instructions to guide Kilo Code's behavior and reduce the need for lengthy explanations in each prompt.
 *   **Choose the Right Model:**  Some models are more cost-effective than others.  Consider using a smaller, faster model for tasks that don't require the full power of a larger model.
 *   **Use Modes:** Different modes can access different tools, for example `Architect` can't modify code, which makes it a safe choice when analyzing a complex codebase, without worrying about accidentally allowing expensive operations.
-*   **Disable MCP If Not Used:** If you're not using MCP (Model Context Protocol) features, consider [disabling it in the MCP settings](/features/mcp/using-mcp-in-kilo-code#enabling-or-disabling-mcp-server-creation) to significantly reduce the size of the system prompt and save tokens.
+*   **Disable MCP If Not Used:** If you're not using MCP (Model Context Protocol) features, consider [disabling it in the MCP settings](/features/mcp/using-mcp-in-kilo-code) to significantly reduce the size of the system prompt and save tokens.
 
 By understanding and managing your API usage, you can use Kilo Code effectively and efficiently.

docs/basic-usage/git-commit-generation.md

@@ -1,4 +1,4 @@
-# Auto-Generate Commit Messages
+# Generate Commit Messages
 
 Generate descriptive commit messages automatically based on your staged git changes. Kilo Code analyzes your staged files and creates conventional commit messages that follow best practices.
 

docs/basic-usage/the-chat-interface.md

@@ -1,43 +1,83 @@
 import Image from '@site/src/components/Image';
 
-# The Chat Interface
+# Chatting with Kilo Code
 
-The Kilo Code chat interface is your primary way of interacting with it. It's located in the Kilo Code panel, which you can open by clicking the Kilo Code icon (<img src="/docs/img/kilo-v1.svg" width="12" />) in the VS Code Primary Side Bar.
+:::tip
 
-The Kilo Code panel can also be moved to the VS Code Secondary Side Bar. If you ever accidentally close the Kilo Code panel, you can get it back using View > Open View... and searching for "Kilo Code".
+**Bottom line:** Kilo Code is an AI coding assistant that lives in VS Code. You chat with it in plain English, and it writes, edits, and explains code for you.
 
-## Components of the Chat Interface
+:::
 
-The chat interface consists of the following main elements:
+## Quick Setup
 
-1. **Chat / Task History:** This area displays the conversation history between you and Kilo Code, or if you are not in a current task the history of all of the tasks you've created.  It shows your requests, Kilo Code's responses, and any actions taken (like file edits or command executions).
+Find the Kilo Code icon (<img src="/docs/img/kilo-v1.svg" width="12" />) in VS Code's Primary Side Bar. Click it to open the chat panel.
 
-2. **Input Field:** This is where you type your tasks and questions for Kilo Code.  You can use [plain English to communicate what you want Kilo Code to do](/basic-usage/typing-your-requests).
+**Lost the panel?** Go to View > Open View... and search for "Kilo Code"
 
-3. **Action Buttons:** These buttons appear below the input field and allow you to approve or reject Kilo Code's proposed actions.  The available buttons change depending on the context and your [auto-approval settings](/features/auto-approving-actions).
+## How to Talk to Kilo Code
 
-4. **Send Button:** This looks like a small plane and it's located to the far right of the input field. This sends messages to Kilo after you've typed them. Alternatively you can just press `Enter`
+**The key insight:** Just type what you want in normal English. No special commands needed.
 
-5. **Plus Button:** The plus button is located at the top in the header, and it starts a new task session.
+<Image src="/docs/img/typing-your-requests/typing-your-requests.png" alt="Example of typing a request in Kilo Code" width="600" />
 
-6. **Settings Button:** The settings button is a gear, and it's used for opening the settings to customize features or behavior.
+**Good requests:**
 
-7. **Mode Selector:** The mode selector is a dropdown located to the left of the chat input field. It is used for selecting which mode Kilo should use for your tasks.
+```
+create a new file named utils.py and add a function called add that takes two numbers as arguments and returns their sum
+```
+
+```
+in the file @src/components/Button.tsx, change the color of the button to blue
+```
+
+```
+find all instances of the variable oldValue in @/src/App.js and replace them with newValue
+```
+
+**What makes requests work:**
+- **Be specific** - "Fix the bug in `calculateTotal` that returns incorrect results" beats "Fix the code"
+- **Use @ mentions** - Reference files and code directly with `@filename`
+- **One task at a time** - Break complex work into manageable steps
+- **Include examples** - Show the style or format you want
+
+
+## The Chat Interface
 
 <Image 
     src="/docs/img/the-chat-interface/the-chat-interface-1.png" 
     alt="Chat interface components labeled with callouts" width="750" 
-    caption="The key components of the Kilo Code chat interface"
+    caption="Everything you need is right here"
 />
 
-## Interacting with Messages
+**Essential controls:**
+- **Chat history** - See your conversation and task history
+- **Input field** - Type your requests here (press Enter to send)
+- **Action buttons** - Approve or reject Kilo's proposed changes
+- **Plus button** - Start a new task session
+- **Mode selector** - Choose how Kilo should approach your task
+
+## Quick Interactions
+
+**Click to act:**
+- File paths → Opens the file
+- URLs → Opens in browser
+- Messages → Expand/collapse details
+- Code blocks → Copy button appears
+
+**Status signals:**
+- Spinning → Kilo is working
+- Red → Error occurred
+- Green → Success
+
+## Common Mistakes to Avoid
 
-* **Clickable Links:** File paths, URLs, and other mentions in the chat history are clickable.  Clicking a file path will open the file in the editor.  Clicking a URL will open it in your default browser.
-* **Copying Text:** You can copy text from the chat history by selecting it and using the standard copy command (`Ctrl/Cmd + C`).  Some elements, like code blocks, have a dedicated "Copy" button.
-* **Expanding and Collapsing**: Click on a message to expand or collapse it.
+| Instead of this... | Try this |
+|-------------------|----------|
+| "Fix the code" | "Fix the bug in `calculateTotal` that returns incorrect results" |
+| Assuming Kilo knows context | Use `@` to reference specific files |
+| Multiple unrelated tasks | Submit one focused request at a time |
+| Technical jargon overload | Clear, straightforward language works best |
 
-## Status Indicators
+**Why it matters:** Kilo Code works best when you communicate like you're talking to a smart teammate who needs clear direction.
 
-* **Loading Spinner:**  When Kilo Code is processing a request, you'll see a loading spinner.
-* **Error Messages:**  If an error occurs, a red error message will be displayed.
-* **Success Messages:** Green messages indicate successful completion of actions.
+Ready to start coding? Open the chat panel and describe what you want to build!

docs/faq.md

@@ -92,7 +92,7 @@ Yes, Kilo Code supports running models locally using [Ollama](/providers/ollama)
 ## Usage
 
 ### How do I start a new task?
-Open the Kilo Code panel (<img src="/docs/img/kilo-v1.svg" width="12" />) and type your task in the chat box. Be clear and specific about what you want Kilo Code to do. See [Typing Your Requests](/basic-usage/typing-your-requests) for best practices.
+Open the Kilo Code panel (<img src="/docs/img/kilo-v1.svg" width="12" />) and type your task in the chat box. Be clear and specific about what you want Kilo Code to do. See [The Chat Interface](/basic-usage/the-chat-interface) for best practices.
 
 ### What are modes in Kilo Code?
 [Modes](/basic-usage/using-modes) are different personas that Kilo Code can adopt, each with a specific focus and set of capabilities. The built-in modes are:

docs/features/browser-use.md

@@ -2,13 +2,8 @@
 
 Kilo Code provides sophisticated browser automation capabilities that let you interact with websites directly from VS Code. This feature enables testing web applications, automating browser tasks, and capturing screenshots without leaving your development environment.
 
-<video width="100%" controls>
-  <source src="/docs/img/browser-use/Roo-Code-Browser-Use.mp4#t=0.001" type="video/mp4"></source>
-  Your browser does not support the video tag.
-</video>
-
 :::info Model Support Required
-Browser Use within Kilo Code requires the use of Claude Sonnet 3.5 or 3.7
+Browser Use within Kilo Code requires the use and advanced agentic model, and has only been tested with Claude Sonnet 3.5, 3.7, and 4
 :::
 
 ## How Browser Use Works

docs/features/experimental/experimental-features.md

@@ -18,20 +18,18 @@ To enable or disable experimental features:
 
 The following experimental features are currently available:
 
-### Search and Replace
+## Autocomplete
+When enabled, Kilo Code will provide inline code suggestions as you type. Currently this requires the Kilo Code API Provider in order to use it.
 
-Adds a new tool for searching and replacing text in a file.
-
-### Insert Content
-
-Adds a new tool for inserting content at any position in a file.
+## Concurrent file edits
+When enabled, Kilo Code can edit multiple files in a single request. When disabled, Kilo Code must edit one file at a time. Disabling this can help when working with less capable models or when you want more control over file modifications.
 
 ### Power Steering
 
 When enabled, Kilo Code will remind the model about the details of its current mode definition more frequently. This will lead to stronger adherence to role definitions and custom instructions, but will use more tokens per message.
 
 ## Providing Feedback
 
-If you encounter any issues with experimental features, or if you have suggestions for improvements, please report them on the [Kilo Code Code GitHub Issues page](https://github.com/Kilo-Org/kilocode).
+If you encounter any issues with experimental features, or if you have suggestions for improvements, please report them on the [Kilo Code Code GitHub Issues page](https://github.com/Kilo-Org/kilocode) or join our [Discord server](https://kilo.love/discord) where we have channels dedciated to many experimental features.
 
 Your feedback is valuable and helps us improve Kilo Code!