feat(cli): add --project and --global flags to /model for per-project model persistence

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

@@ -1435,6 +1435,8 @@ export default {
     'Switch the model for this session (--fast for suggestion model, --voice for voice transcription model, [model-id] to switch immediately).',
   'Switch the model for this session (--fast for suggestion model, --voice for voice transcription model, --vision for the vision bridge model, [model-id] to switch immediately).':
     'Switch the model for this session (--fast for suggestion model, --voice for voice transcription model, --vision for the vision bridge model, [model-id] to switch immediately).',
+  'Switch the model for this session (--fast for suggestion model, --voice for voice transcription model, --vision for the vision bridge model, --project to persist to project settings, --global to persist to user settings, [model-id] to switch immediately).':
+    'Switch the model for this session (--fast for suggestion model, --voice for voice transcription model, --vision for the vision bridge model, --project to persist to project settings, --global to persist to user settings, [model-id] to switch immediately).',
   "⚠ '{{model}}' is not a known image-capable model; the vision bridge may fail on images.":
     "⚠ '{{model}}' is not a known image-capable model; the vision bridge may fail on images.",
   'Set a lighter model for prompt suggestions and speculative execution':
@@ -1444,6 +1446,10 @@ export default {
     'Set the model for voice transcription',
   'Set the image-capable model used to transcribe images for a text-only main model':
     'Set the image-capable model used to transcribe images for a text-only main model',
+  'Persist the model selection to the project settings (workspace scope)':
+    'Persist the model selection to the project settings (workspace scope)',
+  'Persist the model selection to the user settings (global scope)':
+    'Persist the model selection to the user settings (global scope)',
   'Select Fast Model': 'Select Fast Model',
   'Select Vision Model': 'Select Vision Model',
   'Select Voice Model': 'Select Voice Model',
@@ -1680,6 +1686,12 @@ export default {
   // Dialogs - Model
   // ============================================================================
   'Select Model': 'Select Model',
+  'Select Model (this project)': 'Select Model (this project)',
+  'Select Model (global)': 'Select Model (global)',
+  ' (this project)': ' (this project)',
+  ' (global)': ' (global)',
+  'Model: {{model}} (project)': 'Model: {{model}} (project)',
+  'Model: {{model}} (global)': 'Model: {{model}} (global)',
   'API Key': 'API Key',
   '(default)': '(default)',
   '(not set)': '(not set)',

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

@@ -1232,6 +1232,8 @@ export default {
     '切換此會話的模型（--fast 可設置建議模型，--voice 可設置語音轉寫模型，[model-id] 可立即切換）',
   'Switch the model for this session (--fast for suggestion model, --voice for voice transcription model, --vision for the vision bridge model, [model-id] to switch immediately).':
     '切換此會話的模型（--fast 可設置建議模型，--voice 可設置語音轉寫模型，--vision 可設置視覺橋接模型，[model-id] 可立即切換）',
+  'Switch the model for this session (--fast for suggestion model, --voice for voice transcription model, --vision for the vision bridge model, --project to persist to project settings, --global to persist to user settings, [model-id] to switch immediately).':
+    '切換此會話的模型（--fast 建議模型，--voice 語音轉寫模型，--vision 視覺橋接模型，--project 持久化到專案設定，--global 持久化到使用者設定，[model-id] 立即切換）',
   "⚠ '{{model}}' is not a known image-capable model; the vision bridge may fail on images.":
     "⚠ '{{model}}' 不是已知的圖像能力模型；視覺橋接處理圖片時可能會失敗。",
   'Set a lighter model for prompt suggestions and speculative execution':
@@ -1240,6 +1242,10 @@ export default {
   'Set the model for voice transcription': '設定語音轉寫模型',
   'Set the image-capable model used to transcribe images for a text-only main model':
     '設定用於為純文字主模型轉寫圖像的圖像能力模型',
+  'Persist the model selection to the project settings (workspace scope)':
+    '將模型選擇持久化到專案設定（工作區）',
+  'Persist the model selection to the user settings (global scope)':
+    '將模型選擇持久化到使用者設定（全域）',
   'Select Fast Model': '選擇快速模型',
   'Select Vision Model': '選擇視覺模型',
   'Select Voice Model': '選擇語音模型',
@@ -1433,6 +1439,12 @@ export default {
   'Invalid QWEN_DEFAULT_AUTH_TYPE value: "{{value}}". Valid values are: {{validValues}}':
     '無效的 QWEN_DEFAULT_AUTH_TYPE 值："{{value}}"。有效值為：{{validValues}}',
   'Select Model': '選擇模型',
+  'Select Model (this project)': '選擇模型（當前專案）',
+  'Select Model (global)': '選擇模型（全域）',
+  ' (this project)': '（當前專案）',
+  ' (global)': '（全域）',
+  'Model: {{model}} (project)': '模型：{{model}}（專案）',
+  'Model: {{model}} (global)': '模型：{{model}}（全域）',
   'API Key': 'API Key',
   '(default)': '(默認)',
   '(not set)': '(未設置)',

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

@@ -1346,6 +1346,8 @@ export default {
     '切换此会话的模型（--fast 可设置建议模型，--voice 可设置语音转写模型，[model-id] 可立即切换）',
   'Switch the model for this session (--fast for suggestion model, --voice for voice transcription model, --vision for the vision bridge model, [model-id] to switch immediately).':
     '切换此会话的模型（--fast 可设置建议模型，--voice 可设置语音转写模型，--vision 可设置视觉桥接模型，[model-id] 可立即切换）',
+  'Switch the model for this session (--fast for suggestion model, --voice for voice transcription model, --vision for the vision bridge model, --project to persist to project settings, --global to persist to user settings, [model-id] to switch immediately).':
+    '切换此会话的模型（--fast 建议模型，--voice 语音转写模型，--vision 视觉桥接模型，--project 持久化到项目设置，--global 持久化到用户设置，[model-id] 立即切换）',
   "⚠ '{{model}}' is not a known image-capable model; the vision bridge may fail on images.":
     "⚠ '{{model}}' 不是已知的图像能力模型；视觉桥接处理图片时可能会失败。",
   'Set a lighter model for prompt suggestions and speculative execution':
@@ -1354,6 +1356,10 @@ export default {
   'Set the model for voice transcription': '设置语音转写模型',
   'Set the image-capable model used to transcribe images for a text-only main model':
     '设置用于为纯文本主模型转写图像的图像能力模型',
+  'Persist the model selection to the project settings (workspace scope)':
+    '将模型选择持久化到项目设置（工作区）',
+  'Persist the model selection to the user settings (global scope)':
+    '将模型选择持久化到用户设置（全局）',
   'Select Fast Model': '选择快速模型',
   'Select Vision Model': '选择视觉模型',
   'Select Voice Model': '选择语音模型',
@@ -1575,6 +1581,12 @@ export default {
   // Dialogs - Model
   // ============================================================================
   'Select Model': '选择模型',
+  'Select Model (this project)': '选择模型（当前项目）',
+  'Select Model (global)': '选择模型（全局）',
+  ' (this project)': '（当前项目）',
+  ' (global)': '（全局）',
+  'Model: {{model}} (project)': '模型：{{model}}（项目）',
+  'Model: {{model}} (global)': '模型：{{model}}（全局）',
   'API Key': 'API Key',
   '(default)': '(默认)',
   '(not set)': '(未设置)',

packages/cli/src/ui/AppContainer.tsx

@@ -1100,6 +1100,7 @@ export const AppContainer = (props: AppContainerProps) => {
     isFastModelMode,
     isVoiceModelMode,
     isVisionModelMode,
+    modelDialogPersistScope,
     openModelDialog,
     closeModelDialog,
   } = useModelCommand();
@@ -3667,6 +3668,7 @@ export const AppContainer = (props: AppContainerProps) => {
       isFastModelMode,
       isVoiceModelMode,
       isVisionModelMode,
+      modelDialogPersistScope,
       isTrustDialogOpen,
       activeArenaDialog,
       isPermissionsDialogOpen,
@@ -3806,6 +3808,7 @@ export const AppContainer = (props: AppContainerProps) => {
       isFastModelMode,
       isVoiceModelMode,
       isVisionModelMode,
+      modelDialogPersistScope,
       isTrustDialogOpen,
       activeArenaDialog,
       isPermissionsDialogOpen,

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

@@ -45,7 +45,7 @@ describe('modelCommand', () => {
   it('should have the correct name and description', () => {
     expect(modelCommand.name).toBe('model');
     expect(modelCommand.description).toBe(
-      'Switch the model for this session (--fast for suggestion model, --voice for voice transcription model, --vision for the vision bridge model, [model-id] to switch immediately).',
+      'Switch the model for this session (--fast for suggestion model, --voice for voice transcription model, --vision for the vision bridge model, --project to persist to project settings, --global to persist to user settings, [model-id] to switch immediately).',
     );
   });
 
@@ -1669,4 +1669,147 @@ describe('modelCommand', () => {
       });
     });
   });
+
+  describe('scope flags', () => {
+    function setupContext() {
+      const mockConfig = createMockConfig({
+        model: 'test-model',
+        authType: AuthType.USE_OPENAI,
+      });
+      (
+        mockConfig as Partial<Config> & { [key: string]: unknown }
+      ).getAvailableModelsForAuthType = vi.fn().mockReturnValue([]);
+      (
+        mockConfig as Partial<Config> & { [key: string]: unknown }
+      ).getAllConfiguredModels = vi.fn().mockReturnValue([]);
+      mockContext.services.config = mockConfig as Config;
+      return mockContext;
+    }
+
+    it('should include persistScope in dialog return for /model --project', async () => {
+      const ctx = setupContext();
+      const result = await modelCommand.action!(ctx, '--project');
+      expect(result).toEqual({
+        type: 'dialog',
+        dialog: 'model',
+        persistScope: 'workspace',
+      });
+    });
+
+    it('should include persistScope in dialog return for /model --global', async () => {
+      const ctx = setupContext();
+      const result = await modelCommand.action!(ctx, '--global');
+      expect(result).toEqual({
+        type: 'dialog',
+        dialog: 'model',
+        persistScope: 'user',
+      });
+    });
+
+    it('should include persistScope for /model --project --fast dialog', async () => {
+      const ctx = setupContext();
+      const result = await modelCommand.action!(ctx, '--project --fast');
+      expect(result).toEqual({
+        type: 'dialog',
+        dialog: 'fast-model',
+        persistScope: 'workspace',
+      });
+    });
+
+    it('should include persistScope for /model --global --voice dialog', async () => {
+      const ctx = setupContext();
+      const result = await modelCommand.action!(ctx, '--global --voice');
+      expect(result).toEqual({
+        type: 'dialog',
+        dialog: 'voice-model',
+        persistScope: 'user',
+      });
+    });
+
+    it('should include persistScope for /model --project --vision dialog', async () => {
+      const ctx = setupContext();
+      const result = await modelCommand.action!(ctx, '--project --vision');
+      expect(result).toEqual({
+        type: 'dialog',
+        dialog: 'vision-model',
+        persistScope: 'workspace',
+      });
+    });
+
+    it('should parse scope flags in any position', async () => {
+      const ctx = setupContext();
+      const result = await modelCommand.action!(ctx, '--fast --project');
+      expect(result).toEqual({
+        type: 'dialog',
+        dialog: 'fast-model',
+        persistScope: 'workspace',
+      });
+    });
+
+    it('should show scope suffix in fast model confirmation', async () => {
+      const setValue = vi.fn();
+      const settings = {
+        ...createMockSettings(setValue),
+        _merged: {},
+        computeMergedSettings: vi.fn(),
+      } as unknown as LoadedSettings;
+      const ctx = setupContext();
+      ctx.services.settings = settings;
+      const cfg = ctx.services.config as unknown as Partial<Config> & {
+        [key: string]: unknown;
+      };
+      cfg.getAllConfiguredModels = vi
+        .fn()
+        .mockReturnValue([
+          { id: 'qwen3-coder-flash', voiceOnly: false, fastOnly: true },
+        ]);
+      cfg.setFastModel = vi.fn();
+      const result = await modelCommand.action!(
+        ctx,
+        '--project --fast qwen3-coder-flash',
+      );
+      expect(result).toMatchObject({
+        type: 'message',
+        content: expect.stringContaining('(project)'),
+      });
+    });
+
+    it('should show scope suffix in main model confirmation', async () => {
+      const setValue = vi.fn();
+      const settings = {
+        ...createMockSettings(setValue),
+        _merged: {},
+        computeMergedSettings: vi.fn(),
+      } as unknown as LoadedSettings;
+      const mockGenerator = {
+        authType: AuthType.USE_OPENAI,
+        model: 'qwen-max',
+      };
+      const ctx = setupContext();
+      ctx.services.settings = settings;
+      const cfg = ctx.services.config as unknown as Partial<Config> & {
+        [key: string]: unknown;
+      };
+      cfg.getAvailableModelsForAuthType = vi
+        .fn()
+        .mockReturnValue([
+          { id: 'qwen-max', voiceOnly: false, fastOnly: false },
+        ]);
+      cfg.switchModel = vi.fn().mockResolvedValue(mockGenerator);
+      const result = await modelCommand.action!(ctx, '--project qwen-max');
+      expect(result).toMatchObject({
+        type: 'message',
+        content: expect.stringContaining('(project)'),
+      });
+    });
+
+    it('should not include persistScope when no scope flag is given', async () => {
+      const ctx = setupContext();
+      const result = await modelCommand.action!(ctx, '');
+      expect(result).toEqual({
+        type: 'dialog',
+        dialog: 'model',
+      });
+    });
+  });
 });