feat(cli): add configurable plansDirectory for Plan Mode

packages/cli/src/config/config.test.ts

@@ -2409,6 +2409,17 @@ describe('loadCliConfig with includeDirectories', () => {
       ToolNames.SHELL,
     ]);
   });
+
+  it('should preserve plansDirectory in bare mode', async () => {
+    process.argv = ['node', 'script.js', '--bare'];
+    const argv = await parseArguments();
+    const settings: Settings = {
+      plansDirectory: './project-plans',
+    };
+    const config = await loadCliConfig(settings, argv, undefined, []);
+
+    expect(config.getPlansDir()).toContain('project-plans');
+  });
 });
 
 describe('loadCliConfig chatCompression', () => {
@@ -3393,3 +3404,41 @@ describe('loadCliConfig runtimeOutputDir', () => {
     expect(Storage.getRuntimeBaseDir()).toBe(Storage.getGlobalQwenDir());
   });
 });
+
+describe('loadCliConfig plansDirectory', () => {
+  const originalArgv = process.argv;
+
+  beforeEach(() => {
+    process.argv = ['node', 'script.js'];
+  });
+
+  afterEach(() => {
+    process.argv = originalArgv;
+    vi.restoreAllMocks();
+  });
+
+  it('should resolve relative plansDirectory against cwd', async () => {
+    const argv = await parseArguments();
+    const cwd = path.resolve('workspace', 'my-project');
+    const settings: Settings = {
+      plansDirectory: './project-plans',
+    };
+
+    const config = await loadCliConfig(settings, argv, cwd);
+
+    expect(config.getPlansDir()).toBe(path.join(cwd, 'project-plans'));
+    expect(config.getPlanFilePath()).toContain(path.join(cwd, 'project-plans'));
+  });
+
+  it('should reject plansDirectory values outside cwd', async () => {
+    const argv = await parseArguments();
+    const cwd = path.resolve('workspace', 'my-project');
+    const settings: Settings = {
+      plansDirectory: '../plans',
+    };
+
+    await expect(loadCliConfig(settings, argv, cwd)).rejects.toThrow(
+      'plansDirectory must resolve within the project root',
+    );
+  });
+});

packages/cli/src/config/config.ts

@@ -1685,6 +1685,7 @@ export async function loadCliConfig(
     fileFiltering: settings.context?.fileFiltering,
     checkpointing:
       argv.checkpointing || settings.general?.checkpointing?.enabled,
+    plansDirectory: settings.plansDirectory,
     proxy:
       argv.proxy ||
       settings.proxy ||

packages/cli/src/config/settingsSchema.test.ts

@@ -22,13 +22,13 @@ describe('SettingsSchema', () => {
         'ide',
         'privacy',
         'telemetry',
-        'proxy',
         'model',
         'context',
         'tools',
         'mcp',
         'security',
         'advanced',
+        'plansDirectory',
       ];
 
       expectedSettings.forEach((setting) => {
@@ -129,6 +129,15 @@ describe('SettingsSchema', () => {
       expect(getSettingsSchema().proxy.showInDialog).toBe(false);
     });
 
+    it('should have plansDirectory setting in schema', () => {
+      expect(getSettingsSchema().plansDirectory).toBeDefined();
+      expect(getSettingsSchema().plansDirectory.type).toBe('string');
+      expect(getSettingsSchema().plansDirectory.category).toBe('Advanced');
+      expect(getSettingsSchema().plansDirectory.default).toBe(undefined);
+      expect(getSettingsSchema().plansDirectory.requiresRestart).toBe(true);
+      expect(getSettingsSchema().plansDirectory.showInDialog).toBe(false);
+    });
+
     it('should have unique categories', () => {
       const categories = new Set();
 
@@ -251,15 +260,13 @@ describe('SettingsSchema', () => {
           includeDirectories: ['/path/to/dir'],
           loadFromIncludeDirectories: true,
         },
-        proxy: 'http://localhost:7890',
       };
 
       // TypeScript should not complain about these properties
       expect(settings.ui?.theme).toBe('dark');
       expect(settings.ui?.renderMode).toBe('raw');
       expect(settings.context?.includeDirectories).toEqual(['/path/to/dir']);
       expect(settings.context?.loadFromIncludeDirectories).toBe(true);
-      expect(settings.proxy).toBe('http://localhost:7890');
     });
 
     it('should have includeDirectories setting in schema', () => {

packages/cli/src/config/settingsSchema.ts

@@ -300,6 +300,17 @@ const SETTINGS_SCHEMA = {
     mergeStrategy: MergeStrategy.REPLACE,
   },
 
+  plansDirectory: {
+    type: 'string',
+    label: 'Plans Directory',
+    category: 'Advanced',
+    requiresRestart: true,
+    default: undefined as string | undefined,
+    description:
+      'Custom directory for approved Plan Mode files. Relative paths are resolved from the project root, and the resolved path must stay within the project root. Defaults to ~/.qwen/plans.',
+    showInDialog: false,
+  },
+
   // Environment variables fallback
   env: {
     type: 'object',