diff --git a/apps/kilocode-docs/pages/code-with-ai/agents/using-modes.md b/apps/kilocode-docs/pages/code-with-ai/agents/using-modes.md
index ee1279df943..00f6f06e427 100644
--- a/apps/kilocode-docs/pages/code-with-ai/agents/using-modes.md
+++ b/apps/kilocode-docs/pages/code-with-ai/agents/using-modes.md
@@ -24,10 +24,19 @@ Four ways to switch modes:
 
     {% image src="/docs/img/modes/modes.png" alt="Using the dropdown menu to switch modes" width="400" /%}
 
-2. **Slash command:** Type `/architect`, `/ask`, `/debug`, or `/code` in the chat input
+2. **Slash command:** Type `/architect`, `/ask`, `/debug`, or `/code` in the chat input to switch modes. Type `/newtask` to create a new task, or `/smol` to condense your context window.
 
     {% image src="/docs/img/modes/modes-1.png" alt="Using slash commands to switch modes" width="400" /%}
 
+### Understanding /newtask vs /smol
+
+Users often confuse `/newtask` and `/smol`. Here's the key difference:
+
+| Command    | Purpose                                               | When to Use                                                             |
+| ---------- | ----------------------------------------------------- | ----------------------------------------------------------------------- |
+| `/newtask` | Creates a new task with context from the current task | When you want to start something new while carrying over context        |
+| `/smol`    | Condenses your current context window                 | When your conversation is getting too long and you want to summarize it |
+
 3. **Toggle command/Keyboard shortcut:** Use the keyboard shortcut below, applicable to your operating system. Each press cycles through the available modes in sequence, wrapping back to the first mode after reaching the end.
 
     | Operating System | Shortcut |
diff --git a/apps/kilocode-docs/pages/code-with-ai/platforms/cli.md b/apps/kilocode-docs/pages/code-with-ai/platforms/cli.md
index 329cb8fe670..597511bc85a 100644
--- a/apps/kilocode-docs/pages/code-with-ai/platforms/cli.md
+++ b/apps/kilocode-docs/pages/code-with-ai/platforms/cli.md
@@ -164,8 +164,13 @@ Review your code locally before pushing — catch issues early without waiting f
 
 Configuration is managed through:
 
-- `/connect` command for provider setup (interactive)
-- Config files directly at `~/.config/kilo/config.json`
+## Slash Commands
+
+The CLI's interactive mode supports slash commands for common operations. The main commands are documented above in the [Interactive Slash Commands](#interactive-slash-commands) section.
+
+{% callout type="tip" %}
+**Confused about /newtask vs /smol in the IDE?** See the [Using Modes](/docs/code-with-ai/agents/using-modes#understanding-newtask-vs-smol) documentation for details.
+{% /callout %}
 - `kilo auth` for credential management
 
 ## Permissions