add parallel mode docs (#3416)

Author: iscekic

apps/kilocode-docs/docs/cli.md

@@ -61,6 +61,26 @@ to complete configuration with an interactive workflow on the command line.
 You can also use the `/config` slash command during an interactive session, which is equivalent to running `kilocode config`.
 :::
 
+## Parallel mode
+
+Parallel mode allows multiple Kilo Code instances to work in parallel on the same directory, without conflicts. You can spawn as many Kilo Code instances as you need! Once finished, changes will be available on a separate git branch.
+
+```bash
+# Prerequisite: must be within a valid git repository
+
+# In interactive mode, changes will be committed on /exit
+# Terminal 1
+kilocode --parallel "improve xyz"
+# Terminal 2
+kilocode --parallel "improve abc"
+
+# Pairs great with auto mode 🚀
+# Terminal 1
+kilocode --parallel --auto "improve xyz"
+# Terminal 2
+kilocode --parallel --auto "improve abc"
+```
+
 ## Autonomous mode (Non-Interactive)
 
 Autonomous mode allows Kilo Code to run in automated environments like CI/CD pipelines without requiring user interaction.

cli/README.md

@@ -45,6 +45,26 @@ kilocode --mode architect
 kilocode --workspace /path/to/project
 ```
 
+### Parallel mode
+
+Parallel mode allows multiple Kilo Code instances to work in parallel on the same directory, without conflicts. You can spawn as many Kilo Code instances as you need! Once finished, changes will be available on a separate git branch.
+
+```bash
+# Prerequisite: must be within a valid git repository
+
+# In interactive mode, changes will be committed on /exit
+# Terminal 1
+kilocode --parallel "improve xyz"
+# Terminal 2
+kilocode --parallel "improve abc"
+
+# Pairs great with auto mode 🚀
+# Terminal 1
+kilocode --parallel --auto "improve xyz"
+# Terminal 2
+kilocode --parallel --auto "improve abc"
+```
+
 ### Autonomous mode (Non-Interactive)
 
 Autonomous mode allows Kilo Code to run in automated environments like CI/CD pipelines without requiring user interaction.