feat(cli): implement /plan command for plan mode

docs/users/features/commands.md

@@ -61,6 +61,7 @@ Commands for managing AI tools and models.
 | `/mcp`           | List configured MCP servers and tools             | `/mcp`, `/mcp desc`                           |
 | `/tools`         | Display currently available tool list             | `/tools`, `/tools desc`                       |
 | `/skills`        | List and run available skills                     | `/skills`, `/skills <name>`                   |
+| `/plan`          | Switch to plan mode or execute the current plan   | `/plan`, `/plan execute`                      |
 | `/approval-mode` | Change approval mode for tool usage               | `/approval-mode <mode (auto-edit)> --project` |
 | →`plan`          | Analysis only, no execution                       | Secure review                                 |
 | →`default`       | Require approval for edits                        | Daily use                                     |

packages/cli/src/i18n/locales/de.js

@@ -1968,4 +1968,15 @@ export default {
     'Raw-Modus nicht verfügbar. Bitte in einem interaktiven Terminal ausführen.',
   '(Use ↑ ↓ arrows to navigate, Enter to select, Ctrl+C to exit)\n':
     '(↑ ↓ Pfeiltasten zum Navigieren, Enter zum Auswählen, Strg+C zum Beenden)\n',
+
+  'Switch to plan mode or execute the current plan':
+    'Switch to plan mode or execute the current plan',
+  'Exited plan mode. The agent will now execute the plan.':
+    'Exited plan mode. The agent will now execute the plan.',
+  'Enabled plan mode. The agent will analyze and plan without executing tools.':
+    'Enabled plan mode. The agent will analyze and plan without executing tools.',
+  'Already in plan mode. Use "/plan execute" to execute the plan.':
+    'Already in plan mode. Use "/plan execute" to execute the plan.',
+  'Not in plan mode. Use "/plan" to enter plan mode first.':
+    'Not in plan mode. Use "/plan" to enter plan mode first.',
 };

packages/cli/src/i18n/locales/en.js

@@ -2008,4 +2008,15 @@ export default {
     'Raw mode not available. Please run in an interactive terminal.',
   '(Use ↑ ↓ arrows to navigate, Enter to select, Ctrl+C to exit)\n':
     '(Use ↑ ↓ arrows to navigate, Enter to select, Ctrl+C to exit)\n',
+
+  'Switch to plan mode or execute the current plan':
+    'Switch to plan mode or execute the current plan',
+  'Exited plan mode. The agent will now execute the plan.':
+    'Exited plan mode. The agent will now execute the plan.',
+  'Enabled plan mode. The agent will analyze and plan without executing tools.':
+    'Enabled plan mode. The agent will analyze and plan without executing tools.',
+  'Already in plan mode. Use "/plan execute" to execute the plan.':
+    'Already in plan mode. Use "/plan execute" to execute the plan.',
+  'Not in plan mode. Use "/plan" to enter plan mode first.':
+    'Not in plan mode. Use "/plan" to enter plan mode first.',
 };

packages/cli/src/i18n/locales/ja.js

@@ -1460,4 +1460,15 @@ export default {
     'Rawモードが利用できません。インタラクティブターミナルで実行してください。',
   '(Use ↑ ↓ arrows to navigate, Enter to select, Ctrl+C to exit)\n':
     '(↑ ↓ 矢印キーで移動、Enter で選択、Ctrl+C で終了)\n',
+
+  'Switch to plan mode or execute the current plan':
+    'Switch to plan mode or execute the current plan',
+  'Exited plan mode. The agent will now execute the plan.':
+    'Exited plan mode. The agent will now execute the plan.',
+  'Enabled plan mode. The agent will analyze and plan without executing tools.':
+    'Enabled plan mode. The agent will analyze and plan without executing tools.',
+  'Already in plan mode. Use "/plan execute" to execute the plan.':
+    'Already in plan mode. Use "/plan execute" to execute the plan.',
+  'Not in plan mode. Use "/plan" to enter plan mode first.':
+    'Not in plan mode. Use "/plan" to enter plan mode first.',
 };

packages/cli/src/i18n/locales/pt.js

@@ -1958,4 +1958,15 @@ export default {
     'Modo raw não disponível. Execute em um terminal interativo.',
   '(Use ↑ ↓ arrows to navigate, Enter to select, Ctrl+C to exit)\n':
     '(Use ↑ ↓ para navegar, Enter para selecionar, Ctrl+C para sair)\n',
+
+  'Switch to plan mode or execute the current plan':
+    'Switch to plan mode or execute the current plan',
+  'Exited plan mode. The agent will now execute the plan.':
+    'Exited plan mode. The agent will now execute the plan.',
+  'Enabled plan mode. The agent will analyze and plan without executing tools.':
+    'Enabled plan mode. The agent will analyze and plan without executing tools.',
+  'Already in plan mode. Use "/plan execute" to execute the plan.':
+    'Already in plan mode. Use "/plan execute" to execute the plan.',
+  'Not in plan mode. Use "/plan" to enter plan mode first.':
+    'Not in plan mode. Use "/plan" to enter plan mode first.',
 };

packages/cli/src/i18n/locales/ru.js

@@ -1965,4 +1965,15 @@ export default {
     'Raw-режим недоступен. Пожалуйста, запустите в интерактивном терминале.',
   '(Use ↑ ↓ arrows to navigate, Enter to select, Ctrl+C to exit)\n':
     '(↑ ↓ стрелки для навигации, Enter для выбора, Ctrl+C для выхода)\n',
+
+  'Switch to plan mode or execute the current plan':
+    'Switch to plan mode or execute the current plan',
+  'Exited plan mode. The agent will now execute the plan.':
+    'Exited plan mode. The agent will now execute the plan.',
+  'Enabled plan mode. The agent will analyze and plan without executing tools.':
+    'Enabled plan mode. The agent will analyze and plan without executing tools.',
+  'Already in plan mode. Use "/plan execute" to execute the plan.':
+    'Already in plan mode. Use "/plan execute" to execute the plan.',
+  'Not in plan mode. Use "/plan" to enter plan mode first.':
+    'Not in plan mode. Use "/plan" to enter plan mode first.',
 };

packages/cli/src/i18n/locales/zh.js

@@ -1813,4 +1813,15 @@ export default {
     '原始模式不可用。请在交互式终端中运行。',
   '(Use ↑ ↓ arrows to navigate, Enter to select, Ctrl+C to exit)\n':
     '(使用 ↑ ↓ 箭头导航，Enter 选择，Ctrl+C 退出)\n',
+
+  'Switch to plan mode or execute the current plan':
+    '切换到计划模式或执行当前计划',
+  'Exited plan mode. The agent will now execute the plan.':
+    '退出计划模式。智能体现在将执行计划。',
+  'Enabled plan mode. The agent will analyze and plan without executing tools.':
+    '启用计划模式。智能体将只分析和规划，而不执行工具。',
+  'Already in plan mode. Use "/plan execute" to execute the plan.':
+    '已处于计划模式。使用 "/plan execute" 执行计划。',
+  'Not in plan mode. Use "/plan" to enter plan mode first.':
+    '未处于计划模式。请先使用 "/plan" 进入计划模式。',
 };

packages/cli/src/services/BuiltinCommandLoader.ts

@@ -32,6 +32,7 @@ import { languageCommand } from '../ui/commands/languageCommand.js';
 import { mcpCommand } from '../ui/commands/mcpCommand.js';
 import { memoryCommand } from '../ui/commands/memoryCommand.js';
 import { modelCommand } from '../ui/commands/modelCommand.js';
+import { planCommand } from '../ui/commands/planCommand.js';
 import { permissionsCommand } from '../ui/commands/permissionsCommand.js';
 import { trustCommand } from '../ui/commands/trustCommand.js';
 import { quitCommand } from '../ui/commands/quitCommand.js';
@@ -103,6 +104,7 @@ export class BuiltinCommandLoader implements ICommandLoader {
       mcpCommand,
       memoryCommand,
       modelCommand,
+      planCommand,
       permissionsCommand,
       ...(this.config?.getFolderTrust() ? [trustCommand] : []),
       quitCommand,

packages/cli/src/ui/commands/planCommand.test.ts

@@ -0,0 +1,134 @@
+/**
+ * @license
+ * Copyright 2026 Qwen Team
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import { describe, it, expect, beforeEach, vi, type Mock } from 'vitest';
+import { planCommand } from './planCommand.js';
+import { type CommandContext } from './types.js';
+import { createMockCommandContext } from '../../test-utils/mockCommandContext.js';
+import { ApprovalMode } from '@qwen-code/qwen-code-core';
+
+describe('planCommand', () => {
+  let mockContext: CommandContext;
+
+  beforeEach(() => {
+    mockContext = createMockCommandContext({
+      services: {
+        config: {
+          getApprovalMode: vi.fn().mockReturnValue(ApprovalMode.DEFAULT),
+          setApprovalMode: vi.fn(),
+        } as unknown as import('@qwen-code/qwen-code-core').Config,
+      },
+    });
+  });
+
+  it('should switch to plan mode if not in plan mode', async () => {
+    if (!planCommand.action) {
+      throw new Error('The plan command must have an action.');
+    }
+
+    const result = await planCommand.action(mockContext, '');
+
+    expect(mockContext.services.config?.setApprovalMode).toHaveBeenCalledWith(
+      ApprovalMode.PLAN,
+    );
+    expect(result).toEqual({
+      type: 'message',
+      messageType: 'info',
+      content:
+        'Enabled plan mode. The agent will analyze and plan without executing tools.',
+    });
+  });
+
+  it('should return submit prompt if arguments are provided when switching to plan mode', async () => {
+    if (!planCommand.action) {
+      throw new Error('The plan command must have an action.');
+    }
+
+    const result = await planCommand.action(mockContext, 'refactor the code');
+
+    expect(mockContext.services.config?.setApprovalMode).toHaveBeenCalledWith(
+      ApprovalMode.PLAN,
+    );
+    expect(result).toEqual({
+      type: 'submit_prompt',
+      content: [{ text: 'refactor the code' }],
+    });
+  });
+
+  it('should return already in plan mode if mode is already plan', async () => {
+    if (!planCommand.action) {
+      throw new Error('The plan command must have an action.');
+    }
+
+    (mockContext.services.config?.getApprovalMode as Mock).mockReturnValue(
+      ApprovalMode.PLAN,
+    );
+
+    const result = await planCommand.action(mockContext, '');
+
+    expect(mockContext.services.config?.setApprovalMode).not.toHaveBeenCalled();
+    expect(result).toEqual({
+      type: 'message',
+      messageType: 'info',
+      content: 'Already in plan mode. Use "/plan execute" to execute the plan.',
+    });
+  });
+
+  it('should return submit prompt if arguments are provided and already in plan mode', async () => {
+    if (!planCommand.action) {
+      throw new Error('The plan command must have an action.');
+    }
+
+    (mockContext.services.config?.getApprovalMode as Mock).mockReturnValue(
+      ApprovalMode.PLAN,
+    );
+
+    const result = await planCommand.action(mockContext, 'keep planning');
+
+    expect(mockContext.services.config?.setApprovalMode).not.toHaveBeenCalled();
+    expect(result).toEqual({
+      type: 'submit_prompt',
+      content: [{ text: 'keep planning' }],
+    });
+  });
+
+  it('should exit plan mode when execute argument is passed', async () => {
+    if (!planCommand.action) {
+      throw new Error('The plan command must have an action.');
+    }
+
+    (mockContext.services.config?.getApprovalMode as Mock).mockReturnValue(
+      ApprovalMode.PLAN,
+    );
+
+    const result = await planCommand.action(mockContext, 'execute');
+
+    expect(mockContext.services.config?.setApprovalMode).toHaveBeenCalledWith(
+      ApprovalMode.DEFAULT,
+    );
+    expect(result).toEqual({
+      type: 'message',
+      messageType: 'info',
+      content: 'Exited plan mode. The agent will now execute the plan.',
+    });
+  });
+
+  it('should return error when execute is used but not in plan mode', async () => {
+    if (!planCommand.action) {
+      throw new Error('The plan command must have an action.');
+    }
+
+    // Default mock returns ApprovalMode.DEFAULT (not PLAN)
+    const result = await planCommand.action(mockContext, 'execute');
+
+    expect(mockContext.services.config?.setApprovalMode).not.toHaveBeenCalled();
+    expect(result).toEqual({
+      type: 'message',
+      messageType: 'error',
+      content: 'Not in plan mode. Use "/plan" to enter plan mode first.',
+    });
+  });
+});

packages/cli/src/ui/commands/planCommand.ts

@@ -0,0 +1,106 @@
+/**
+ * @license
+ * Copyright 2026 Qwen Team
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import {
+  type CommandContext,
+  CommandKind,
+  type SlashCommand,
+  type MessageActionReturn,
+  type SubmitPromptActionReturn,
+} from './types.js';
+import { t } from '../../i18n/index.js';
+import { ApprovalMode } from '@qwen-code/qwen-code-core';
+
+export const planCommand: SlashCommand = {
+  name: 'plan',
+  get description() {
+    return t('Switch to plan mode or execute the current plan');
+  },
+  kind: CommandKind.BUILT_IN,
+  action: async (
+    context: CommandContext,
+    args: string,
+  ): Promise<MessageActionReturn | SubmitPromptActionReturn> => {
+    const { config } = context.services;
+    if (!config) {
+      return {
+        type: 'message',
+        messageType: 'error',
+        content: t('Configuration is not available.'),
+      };
+    }
+
+    const trimmedArgs = args.trim();
+    const currentMode = config.getApprovalMode();
+
+    if (trimmedArgs === 'execute') {
+      if (currentMode !== ApprovalMode.PLAN) {
+        return {
+          type: 'message',
+          messageType: 'error',
+          content: t('Not in plan mode. Use "/plan" to enter plan mode first.'),
+        };
+      }
+      try {
+        config.setApprovalMode(ApprovalMode.DEFAULT);
+      } catch (e) {
+        return {
+          type: 'message',
+          messageType: 'error',
+          content: (e as Error).message,
+        };
+      }
+      return {
+        type: 'message',
+        messageType: 'info',
+        content: t('Exited plan mode. The agent will now execute the plan.'),
+      };
+    }
+
+    if (currentMode !== ApprovalMode.PLAN) {
+      try {
+        config.setApprovalMode(ApprovalMode.PLAN);
+      } catch (e) {
+        return {
+          type: 'message',
+          messageType: 'error',
+          content: (e as Error).message,
+        };
+      }
+
+      if (trimmedArgs) {
+        return {
+          type: 'submit_prompt',
+          content: [{ text: trimmedArgs }],
+        };
+      }
+
+      return {
+        type: 'message',
+        messageType: 'info',
+        content: t(
+          'Enabled plan mode. The agent will analyze and plan without executing tools.',
+        ),
+      };
+    }
+
+    // Already in plan mode
+    if (trimmedArgs) {
+      return {
+        type: 'submit_prompt',
+        content: [{ text: trimmedArgs }],
+      };
+    }
+
+    return {
+      type: 'message',
+      messageType: 'info',
+      content: t(
+        'Already in plan mode. Use "/plan execute" to execute the plan.',
+      ),
+    };
+  },
+};