Skip to content

Mirror: docs: clarify slash commands /newtask vs /smol (#5869) #5

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jeremylongshore merged 1 commit into from
Feb 15, 2026
Merged

Mirror: docs: clarify slash commands /newtask vs /smol (#5869) #5

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 10 additions & 1 deletion apps/kilocode-docs/pages/code-with-ai/agents/using-modes.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 |
Comment on lines +31 to +38
Copy link
Copy Markdown

@gemini-code-assist gemini-code-assist Bot Feb 14, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

Inserting a level-3 header (###) inside a numbered list breaks the list's continuity in most Markdown parsers. This will cause the subsequent list item (currently step 3) to restart its numbering at '1.' or render incorrectly. To maintain the list structure, you should indent this explanatory section so it remains part of step 2.

Suggested change
### 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 |
### 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 |
Expand Down
9 changes: 7 additions & 2 deletions apps/kilocode-docs/pages/code-with-ai/platforms/cli.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 %}
Comment on lines +167 to +173
Copy link
Copy Markdown

@gemini-code-assist gemini-code-assist Bot Feb 14, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The new 'Slash Commands' header is placed immediately after the 'Configuration is managed through:' sentence, which breaks the grammatical flow and orphans the subsequent list items. Additionally, the reference to the config file location (~/.config/kilo/config.json) was removed. It is better to keep the configuration list intact and place the new section separately.

Suggested change
## 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 %}
- `/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
Comment on lines +167 to 174
Copy link
Copy Markdown

@coderabbitai coderabbitai Bot Feb 14, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Fix document structure: orphaned bullet point.

The new "Slash Commands" section is clear and helpful, but it creates a structural issue. Line 165 says "Configuration is managed through:" which suggests a list should follow, but instead there's a peer-level section header (## Slash Commands), and then a single orphaned bullet point at line 174.

Consider one of these solutions:

  1. Move the kilo auth bullet point before the new Slash Commands section (after line 165)
  2. Convert line 174 to a regular paragraph without the bullet
  3. Update line 165 to not imply a list follows
📝 Proposed fix: Move the bullet point before the new section 
 Configuration is managed through:
 
+- `kilo auth` for credential management
+
 ## 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
🤖 Prompt for AI Agents 
In `@apps/kilocode-docs/pages/code-with-ai/platforms/cli.md` around lines 167 -
174, The document has an orphaned bullet "kilo auth" that follows the sentence
"Configuration is managed through:" but sits after the new "## Slash Commands"
header; move the `kilo auth` bullet so it appears immediately after the
"Configuration is managed through:" sentence (i.e., before the "## Slash
Commands" section) to make the list structurally correct, keeping the "## Slash
Commands" section and its callout unchanged.


## Permissions
Expand Down
Loading