jasonkneen · pull · Jan 6, 2026 · Dec 11, 2025 · Dec 11, 2025 · Dec 11, 2025
diff --git a/.changeset/agent-manager-dropdown-ux.md b/.changeset/agent-manager-dropdown-ux.md
diff --git a/.changeset/agent-manager-question-support.md b/.changeset/agent-manager-question-support.md
diff --git a/.changeset/agents-md-documentation.md b/.changeset/agents-md-documentation.md
@@ -0,0 +1,5 @@
+---
+"kilo-code": patch
+---
+
+Add comprehensive AGENTS.md documentation page to Agent Behavior section
diff --git a/.changeset/append-system-prompt-cli.md b/.changeset/append-system-prompt-cli.md
@@ -0,0 +1,6 @@
+---
+"@kilocode/cli": patch
+"kilo-code": patch
+---
+
+Add `--append-system-prompt` CLI option to append custom instructions to the system prompt
diff --git a/.changeset/calm-stars-join.md b/.changeset/calm-stars-join.md
diff --git a/.changeset/clear-hoops-melt.md b/.changeset/clear-hoops-melt.md
diff --git a/.changeset/cli-api-request-cost-updates.md b/.changeset/cli-api-request-cost-updates.md
diff --git a/.changeset/cli-condense-command.md b/.changeset/cli-condense-command.md
diff --git a/.changeset/cli-esc-cancellation-feedback.md b/.changeset/cli-esc-cancellation-feedback.md
diff --git a/.changeset/cli-formatting-fix.md b/.changeset/cli-formatting-fix.md
diff --git a/.changeset/cli-slash-command-default-selection.md b/.changeset/cli-slash-command-default-selection.md
diff --git a/.changeset/fix-cli-auto-update-nosplash.md b/.changeset/fix-cli-auto-update-nosplash.md
diff --git a/.changeset/fix-mac-exit-message.md b/.changeset/fix-mac-exit-message.md
diff --git a/.changeset/log-file-rotation.md b/.changeset/log-file-rotation.md
diff --git a/.changeset/mode-autocomplete.md b/.changeset/mode-autocomplete.md
diff --git a/.changeset/slimy-pens-check.md b/.changeset/slimy-pens-check.md
diff --git a/.changeset/stupid-mayflies-pay.md b/.changeset/stupid-mayflies-pay.md
@@ -0,0 +1,5 @@
+---
+"kilo-code": patch
+---
+
+Allow null for tool arguments
diff --git a/.changeset/thirty-rocks-shave.md b/.changeset/thirty-rocks-shave.md
diff --git a/.changeset/worktree-migration.md b/.changeset/worktree-migration.md
@@ -0,0 +1,5 @@
+---
+"kilo-code": minor
+---
+
+Migrate worktree creation from CLI to extension for parallel mode sessions
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,21 @@
 # kilo-code
 
+## 4.142.0
+
+### Minor Changes
+
+- [#4587](https://github.com/Kilo-Org/kilocode/pull/4587) [`d1c35c5`](https://github.com/Kilo-Org/kilocode/commit/d1c35c54c253b22a264ee4ce90fd25f5d93343da) Thanks [@hassoncs](https://github.com/hassoncs)! - Improve the initial setup experience for the speech-to-text feature by adding an inline setup tooltip
+
+### Patch Changes
+
+- [#4785](https://github.com/Kilo-Org/kilocode/pull/4785) [`acc529e`](https://github.com/Kilo-Org/kilocode/commit/acc529e884be601d635ad9e714a0f3b2a4e9b639) Thanks [@markijbema](https://github.com/markijbema)! - Removed the cmd-i (quick inline task) functionality, as cmd-k-a (add to context) is now equivalent
+
+- [#4765](https://github.com/Kilo-Org/kilocode/pull/4765) [`725b0bc`](https://github.com/Kilo-Org/kilocode/commit/725b0bc56d1262b9e847861db86a3609c40479d9) Thanks [@Drilmo](https://github.com/Drilmo)! - Fixed exit prompt showing "Cmd+C" instead of "Ctrl+C" on Mac. Ctrl+C is the universal terminal interrupt signal on all platforms.
+
+- [#4787](https://github.com/Kilo-Org/kilocode/pull/4787) [`84033fa`](https://github.com/Kilo-Org/kilocode/commit/84033fa3015a757b358cc4799308b8209646ec5e) Thanks [@markijbema](https://github.com/markijbema)! - Keep config screen in sync with whether chat autocomplete is enabled
+
+- [#4800](https://github.com/Kilo-Org/kilocode/pull/4800) [`c089dc2`](https://github.com/Kilo-Org/kilocode/commit/c089dc2351daefe7690adf1a3f01cc8b82a27409) Thanks [@hassoncs](https://github.com/hassoncs)! - Add fuzzy matching to / commands
+
 ## 4.141.2
 
 ### Patch Changes

diff --git a/apps/kilocode-docs/docs/advanced-usage/agent-manager.md b/apps/kilocode-docs/docs/advanced-usage/agent-manager.md
@@ -42,19 +42,43 @@ You can continue a session later (local or remote):
 
 Parallel Mode runs the agent in an isolated Git worktree branch, keeping your main branch clean.
 
-- Enable the “Parallel Mode” toggle before starting
+- Enable the "Parallel Mode" toggle before starting
 - The extension prevents using Parallel Mode inside an existing worktree
     - Open the main repository (where .git is a directory) to use this feature
-- While running, the Agent Manager parses and surfaces:
-    - Branch name created/used
-    - Worktree path
-    - A completion/merge instruction message when the agent finishes
-- After completion
-    - Review the branch in your VCS UI
-    - Merge or cherry-pick the changes as desired
-    - Clean up the worktree when finished
-
-If you need to resume with Parallel Mode later, the extension re-attaches to the same session with the same branch context.
+
+### Worktree Location
+
+Worktrees are created in `.kilocode/worktrees/` within your project directory. This folder is automatically added to `.gitignore` to prevent accidental commits.
+
+```
+your-project/
+├── .kilocode/
+│   └── worktrees/
+│       └── feature-branch-1234567890/   # isolated working directory
+├── .gitignore                           # auto-updated with .kilocode/worktrees/
+└── ...
+```
+
+### While Running
+
+The Agent Manager surfaces:
+
+- Branch name created/used
+- Worktree path
+- A completion/merge instruction message when the agent finishes
+
+### After Completion
+
+- The worktree is cleaned up automatically, but the branch is preserved
+- Review the branch in your VCS UI
+- Merge or cherry-pick the changes as desired
+
+### Resuming Sessions
+
+If you resume a Parallel Mode session later, the extension will:
+
+1. Reuse the existing worktree if it still exists
+2. Or recreate it from the session's branch
 
 ## Remote sessions (Cloud)
 

diff --git a/apps/kilocode-docs/docs/advanced-usage/code-reviews.md b/apps/kilocode-docs/docs/advanced-usage/code-reviews.md
@@ -159,5 +159,4 @@ The Review Agent is ideal for:
 - The agent reviews **only the changed files**, not the entire repository.
 - Some highly dynamic or domain-specific code may require additional context in custom instructions.
 - The agent will only run on **selected repositories**.
-- **PRs from forks are not supported**. Only pull requests from branches within the same repository can be automatically reviewed.
 - During beta, review capacity may be throttled for extremely large PRs.
diff --git a/apps/kilocode-docs/docs/agent-behavior/agents-md.md b/apps/kilocode-docs/docs/agent-behavior/agents-md.md
@@ -0,0 +1,154 @@
+# AGENTS.md Files
+
+AGENTS.md files provide a standardized way to configure AI agent behavior across different AI coding tools. They allow you to define project-specific instructions, coding standards, and guidelines that AI agents should follow when working with your codebase.
+
+## What is AGENTS.md?
+
+AGENTS.md is an open standard for configuring AI agent behavior in software projects. It's a simple Markdown file placed at the root of your project that contains instructions for AI coding assistants. The standard is supported by multiple AI coding tools, including Kilo Code, Cursor, and Windsurf.
+
+Think of AGENTS.md as a "README for AI agents" - it tells the AI how to work with your specific project, what conventions to follow, and what constraints to respect.
+
+## Why Use AGENTS.md?
+
+- **Portability**: Works across multiple AI coding tools without modification
+- **Version Control**: Lives in your repository alongside your code
+- **Team Consistency**: Ensures all team members' AI assistants follow the same guidelines
+- **Project-Specific**: Tailored to your project's unique requirements and conventions
+- **Simple Format**: Plain Markdown - no special syntax or configuration required
+
+## File Location and Naming
+
+### Project-Level AGENTS.md
+
+Place your AGENTS.md file at the **root of your project**:
+
+```
+my-project/
+├── AGENTS.md          # Primary filename (recommended)
+├── src/
+├── package.json
+└── README.md
+```
+
+**Supported filenames** (in order of precedence):
+
+1. `AGENTS.md` (uppercase, plural - recommended)
+2. `AGENT.md` (uppercase, singular - fallback)
+
+:::warning Case Sensitivity
+The filename must be uppercase (`AGENTS.md`), not lowercase (`agents.md`). This ensures consistency across different operating systems and tools.
+:::
+
+### Subdirectory AGENTS.md Files
+
+You can also place AGENTS.md files in subdirectories to provide context-specific instructions:
+
+```
+my-project/
+├── AGENTS.md                    # Root-level instructions
+├── src/
+│   └── backend/
+│       └── AGENTS.md            # Backend-specific instructions
+└── docs/
+    └── AGENTS.md                # Documentation-specific instructions
+```
+
+When working in a subdirectory, Kilo Code will load both the root AGENTS.md and any subdirectory AGENTS.md files, with subdirectory files taking precedence for conflicting instructions.
+
+## File Protection
+
+Both `AGENTS.md` and `AGENT.md` are **write-protected files** in Kilo Code. This means:
+
+- The AI agent cannot modify these files without explicit user approval
+- You'll be prompted to confirm any changes to these files
+- This prevents accidental modifications to your project's AI configuration
+
+## Basic Syntax and Structure
+
+AGENTS.md files use standard Markdown syntax. There's no required structure, but organizing your content with headers and lists makes it easier for AI models to parse and understand.
+
+### Recommended Structure
+
+```markdown
+# Project Name
+
+Brief description of the project and its purpose.
+
+## Code Style
+
+- Use TypeScript for all new files
+- Follow ESLint configuration
+- Use 2 spaces for indentation
+
+## Architecture
+
+- Follow MVC pattern
+- Keep components under 200 lines
+- Use dependency injection
+
+## Testing
+
+- Write unit tests for all business logic
+- Maintain >80% code coverage
+- Use Jest for testing
+
+## Security
+
+- Never commit API keys or secrets
+- Validate all user inputs
+- Use parameterized queries for database access
+```
+
+## Best Practices
+
+- **Be specific and clear** - Use concrete rules like "limit cyclomatic complexity to < 10" instead of vague guidance like "write good code"
+- **Include code examples** - Show patterns for error handling, naming conventions, or architecture decisions
+- **Organize by category** - Group related guidelines under clear headers (Code Style, Architecture, Testing, Security)
+- **Keep it concise** - Use bullet points and direct language; avoid long paragraphs
+- **Update regularly** - Review and revise as your project's conventions evolve
+
+## How AGENTS.md Works in Kilo Code
+
+### Loading Behavior
+
+When you start a task in Kilo Code:
+
+1. Kilo Code checks for `AGENTS.md` or `AGENT.md` at the project root
+2. If found, the content is loaded and included in the AI's context
+3. The AI follows these instructions throughout the conversation
+4. Changes to AGENTS.md take effect in new tasks (reload may be required)
+
+### Interaction with Other Rules
+
+AGENTS.md works alongside Kilo Code's other configuration systems:
+
+| Feature                                                        | Scope   | Location                  | Purpose                                    | Priority    |
+| -------------------------------------------------------------- | ------- | ------------------------- | ------------------------------------------ | ----------- |
+| **[Mode-specific Custom Rules](/agent-behavior/custom-rules)** | Project | `.kilocode/rules-{mode}/` | Mode-specific rules and constraints        | 1 (Highest) |
+| **[Custom Rules](/agent-behavior/custom-rules)**               | Project | `.kilocode/rules/`        | Kilo Code-specific rules and constraints   | 2           |
+| **AGENTS.md**                                                  | Project | Project root or subfolder | Cross-tool standard for project guidelines | 3           |
+| **[Global Custom Rules](/agent-behavior/custom-rules)**        | Global  | `~/.kilocode/rules/`      | Global Kilo Code rules                     | 4           |
+| **[Custom Instructions](/agent-behavior/custom-instructions)** | Global  | IDE settings              | Personal preferences across all projects   | 5 (Lowest)  |
+
+### Enabling/Disabling AGENTS.md
+
+AGENTS.md support is **enabled by default** in Kilo Code. To disable it, edit `settings.json`:
+
+```json
+{
+	"kilocode.useAgentRules": false
+}
+```
+
+## Related Features
+
+- **[Custom Rules](/agent-behavior/custom-rules)** - Kilo Code-specific rules with more control
+- **[Custom Modes](/agent-behavior/custom-modes)** - Specialized workflows with specific permissions
+- **[Custom Instructions](/agent-behavior/custom-instructions)** - Personal preferences across all projects
+- **[Migrating from Cursor or Windsurf](/advanced-usage/migrating-from-cursor-windsurf)** - Migration guide for other tools
+
+## External Resources
+
+- [AGENTS.md Specification](https://agents.md) - Official standard documentation
+- [dotagent](https://github.com/johnlindquist/dotagent) - Universal converter tool for agent configuration files
+- [awesome-cursorrules](https://github.com/PatrickJS/awesome-cursorrules) - 700+ example rules you can adapt