Feature: Add --force-include option

README.md

@@ -194,6 +194,12 @@ To exclude specific files or directories:
 repomix --ignore "**/*.log,tmp/"
 ```
 
+To force include files (overriding ignore patterns):
+
+```bash
+repomix --force-include "coverage/summary.json,test-results/junit.xml"
+```
+
 To pack a remote repository:
 
 ```bash

src/cli/actions/defaultAction.ts

@@ -100,6 +100,9 @@ export const buildCliConfig = (options: CliOptions): RepomixConfigCli => {
   if (options.include) {
     cliConfig.include = splitPatterns(options.include);
   }
+  if (options.forceInclude) {
+    cliConfig.forceInclude = options.forceInclude.split(',').map((pattern) => pattern.trim());
+  }
   if (options.ignore) {
     cliConfig.ignore = { customPatterns: splitPatterns(options.ignore) };
   }

src/cli/cliRun.ts

@@ -77,6 +77,7 @@ export const run = async () => {
       // Filter Options
       .optionsGroup('Filter Options')
       .option('--include <patterns>', 'list of include patterns (comma-separated)')
+      .option('--force-include <patterns>', 'list of patterns to include, overriding ignores (comma-separated)')
       .option('-i, --ignore <patterns>', 'additional ignore patterns (comma-separated)')
       .option('--no-gitignore', 'disable .gitignore file usage')
       .option('--no-default-patterns', 'disable default patterns')

src/cli/types.ts

@@ -26,6 +26,7 @@ export interface CliOptions extends OptionValues {
 
   // Filter Options
   include?: string;
+  forceInclude?: string;
   ignore?: string;
   gitignore?: boolean;
   defaultPatterns?: boolean;

src/config/configLoad.ts

@@ -130,6 +130,11 @@ export const mergeConfigs = (
       ...cliConfig.output,
     },
     include: [...(baseConfig.include || []), ...(fileConfig.include || []), ...(cliConfig.include || [])],
+    forceInclude: [
+      ...(baseConfig.forceInclude || []),
+      ...(fileConfig.forceInclude || []),
+      ...(cliConfig.forceInclude || []),
+    ],
     ignore: {
       ...baseConfig.ignore,
       ...fileConfig.ignore,

src/config/configSchema.ts

@@ -47,6 +47,7 @@ export const repomixConfigBaseSchema = z.object({
     })
     .optional(),
   include: z.array(z.string()).optional(),
+  forceInclude: z.array(z.string()).optional(),
   ignore: z
     .object({
       useGitignore: z.boolean().optional(),
@@ -104,6 +105,7 @@ export const repomixConfigDefaultSchema = z.object({
     })
     .default({}),
   include: z.array(z.string()).default([]),
+  forceInclude: z.array(z.string()).default([]),
   ignore: z
     .object({
       useGitignore: z.boolean().default(true),

src/core/file/fileSearch.ts

@@ -155,6 +155,7 @@ export const searchFiles = async (rootDir: string, config: RepomixConfigMerged):
     logger.trace('Include patterns:', includePatterns);
     logger.trace('Ignore patterns:', normalizedIgnorePatterns);
     logger.trace('Ignore file patterns:', ignoreFilePatterns);
+    logger.trace('Force include patterns:', config.forceInclude);
 
     // Check if .git is a worktree reference
     const gitPath = path.join(rootDir, '.git');
@@ -171,7 +172,8 @@ export const searchFiles = async (rootDir: string, config: RepomixConfigMerged):
       }
     }
 
-    const filePaths = await globby(includePatterns, {
+    // Step 1: Get initial files with normal include/ignore patterns
+    const initialFilePaths = await globby(includePatterns, {
       cwd: rootDir,
       ignore: [...adjustedIgnorePatterns],
       ignoreFiles: [...ignoreFilePatterns],
@@ -190,6 +192,28 @@ export const searchFiles = async (rootDir: string, config: RepomixConfigMerged):
       throw error;
     });
 
+    // Step 2: If forceInclude is specified, get additional files without applying ignore patterns
+    let forcedFilePaths: string[] = [];
+    if (config.forceInclude.length > 0) {
+      const forceIncludePatterns = config.forceInclude.map((pattern) => escapeGlobPattern(pattern));
+
+      logger.trace('Getting forced include files with patterns:', forceIncludePatterns);
+
+      forcedFilePaths = await globby(forceIncludePatterns, {
+        cwd: rootDir,
+        onlyFiles: true,
+        absolute: false,
+        dot: true,
+        followSymbolicLinks: false,
+        // No ignore or ignoreFiles specified to override ignore settings
+      });
+
+      logger.trace('Found forced include files:', forcedFilePaths);
+    }
+
+    // Step 3: Combine initialFilePaths and forcedFilePaths, removing duplicates
+    const combinedFilePaths = Array.from(new Set([...initialFilePaths, ...forcedFilePaths]));
+
     let emptyDirPaths: string[] = [];
     if (config.output.includeEmptyDirectories) {
       const directories = await globby(includePatterns, {
@@ -205,10 +229,12 @@ export const searchFiles = async (rootDir: string, config: RepomixConfigMerged):
       emptyDirPaths = await findEmptyDirectories(rootDir, directories, adjustedIgnorePatterns);
     }
 
-    logger.trace(`Filtered ${filePaths.length} files`);
+    logger.trace(
+      `Filtered ${combinedFilePaths.length} files (including ${forcedFilePaths.length} forced include files)`,
+    );
 
     return {
-      filePaths: sortPaths(filePaths),
+      filePaths: sortPaths(combinedFilePaths),
       emptyDirPaths: sortPaths(emptyDirPaths),
     };
   } catch (error: unknown) {

tests/cli/actions/defaultAction.test.ts

@@ -48,6 +48,7 @@ describe('defaultAction', () => {
         customPatterns: [],
       },
       include: [],
+      forceInclude: [],
       security: {
         enableSecurityCheck: true,
       },
@@ -530,15 +531,33 @@ describe('defaultAction', () => {
     });
   });
 
+  it('should handle custom force include patterns', async () => {
+    const options: CliOptions = {
+      forceInclude: 'coverage/*.json,test-results/*.xml',
+    };
+
+    await runDefaultAction(['.'], process.cwd(), options);
+
+    expect(configLoader.mergeConfigs).toHaveBeenCalledWith(
+      process.cwd(),
+      expect.anything(),
+      expect.objectContaining({
+        forceInclude: ['coverage/*.json', 'test-results/*.xml'],
+      }),
+    );
+  });
+
   it('should properly trim whitespace from comma-separated patterns', () => {
     const options = {
       include: 'src/**/*,  tests/**/*,   examples/**/*',
       ignore: 'node_modules/**,  dist/**,  coverage/**',
+      forceInclude: 'coverage/*.json,  test-results/*.xml',
     };
     const config = buildCliConfig(options);
 
     expect(config.include).toEqual(['src/**/*', 'tests/**/*', 'examples/**/*']);
     expect(config.ignore?.customPatterns).toEqual(['node_modules/**', 'dist/**', 'coverage/**']);
+    expect(config.forceInclude).toEqual(['coverage/*.json', 'test-results/*.xml']);
   });
 
   describe('files flag', () => {

tests/cli/cliRun.test.ts

@@ -73,6 +73,7 @@ describe('cliRun', () => {
           },
         },
         include: [],
+        forceInclude: [],
         ignore: {
           useGitignore: true,
           useDefaultPatterns: true,
@@ -126,6 +127,7 @@ describe('cliRun', () => {
           },
         },
         include: [],
+        forceInclude: [],
         ignore: {
           useGitignore: true,
           useDefaultPatterns: true,

tests/config/configSchema.test.ts

@@ -83,6 +83,7 @@ describe('configSchema', () => {
           },
         },
         include: [],
+        forceInclude: [],
         ignore: {
           useGitignore: true,
           useDefaultPatterns: true,
@@ -177,6 +178,7 @@ describe('configSchema', () => {
           },
         },
         include: ['**/*.js', '**/*.ts'],
+        forceInclude: ['**/*.js', '**/*.ts', '*.log'],
         ignore: {
           useGitignore: true,
           useDefaultPatterns: true,

tests/core/file/fileSearch.test.ts

@@ -334,11 +334,13 @@ node_modules
         'root/subdir/ignored.js',
       ];
 
-      vi.mocked(globby).mockResolvedValue(mockFileStructure);
+      // Update mock implementation to handle both the initial call and forceInclude call
+      vi.mocked(globby).mockImplementation(() => Promise.resolve(mockFileStructure));
 
       const result = await searchFiles('/mock/root', mockConfig);
 
-      expect(result.filePaths).toEqual(mockFileStructure);
+      // Sort both arrays to ensure order doesn't matter for the test
+      expect(new Set(result.filePaths)).toEqual(new Set(mockFileStructure));
       expect(result.filePaths).toContain('root/subdir/ignored.js');
       expect(result.emptyDirPaths).toEqual([]);
     });

tests/core/metrics/diffTokenCount.test.ts

@@ -73,6 +73,7 @@ index 123..456 100644
         },
       },
       include: [],
+      forceInclude: [],
       ignore: {
         useGitignore: true,
         useDefaultPatterns: true,
@@ -158,6 +159,7 @@ index 123..456 100644
         },
       },
       include: [],
+      forceInclude: [],
       ignore: {
         useGitignore: true,
         useDefaultPatterns: true,
@@ -235,6 +237,7 @@ index 123..456 100644
         },
       },
       include: [],
+      forceInclude: [],
       ignore: {
         useGitignore: true,
         useDefaultPatterns: true,

tests/core/treeSitter/parseFile.solidity.test.ts

@@ -31,6 +31,7 @@ describe('Solidity File Parsing', () => {
       },
     },
     include: [],
+    forceInclude: [],
     ignore: {
       useGitignore: true,
       useDefaultPatterns: true,

tests/mcp/tools/packCodebaseTool.test.ts

@@ -92,6 +92,7 @@ describe('PackCodebaseTool', () => {
         },
         cwd,
         include: Array.isArray(opts.include) ? opts.include : opts.include ? [opts.include] : [],
+        forceInclude: [],
         ignore: {
           useGitignore: true,
           useDefaultPatterns: true,

tests/testing/testUtils.ts

@@ -33,6 +33,7 @@ export const createMockConfig = (config: DeepPartial<RepomixConfigMerged> = {}):
       customPatterns: [...(defaultConfig.ignore.customPatterns || []), ...(config.ignore?.customPatterns || [])],
     },
     include: [...(defaultConfig.include || []), ...(config.include || [])],
+    forceInclude: [...(defaultConfig.forceInclude || []), ...(config.forceInclude || [])],
     security: {
       ...defaultConfig.security,
       ...config.security,

website/client/src/en/guide/command-line-options.md

@@ -24,6 +24,7 @@
 
 ## Filter Options
 - `--include <patterns>`: Include patterns (comma-separated)
+- `--force-include <patterns>`: Force include patterns that override ignore rules (comma-separated)
 - `-i, --ignore <patterns>`: Ignore patterns (comma-separated)
 - `--no-gitignore`: Disable .gitignore file usage
 - `--no-default-patterns`: Disable default patterns
@@ -69,6 +70,9 @@ repomix --compress
 # Process specific files
 repomix --include "src/**/*.ts" --ignore "**/*.test.ts"
 
+# Force include specific files even if they're ignored
+repomix --force-include "coverage/summary.json,test-results/junit.xml"
+
 # Remote repository with branch
 repomix --remote https://github.com/user/repo/tree/main
 

website/client/src/en/guide/configuration.md

@@ -99,6 +99,7 @@ Here's an example of a complete configuration file (`repomix.config.json`):
     }
   },
   "include": ["**/*"],
+  "forceInclude": ["coverage/summary.json", "test-results/junit.xml"],
   "ignore": {
     "useGitignore": true,
     "useDefaultPatterns": true,
@@ -131,10 +132,11 @@ Command-line options take precedence over configuration file settings.
 
 Repomix provides multiple ways to specify which files should be ignored. The patterns are processed in the following priority order:
 
-1. CLI options (`--ignore`)
-2. `.repomixignore` file in the project directory
-3. `.gitignore` and `.git/info/exclude` (if `ignore.useGitignore` is true)
-4. Default patterns (if `ignore.useDefaultPatterns` is true)
+1. Force include patterns (`--force-include`)
+2. CLI options (`--ignore`)
+3. `.repomixignore` file in the project directory
+4. `.gitignore` and `.git/info/exclude` (if `ignore.useGitignore` is true)
+5. Default patterns (if `ignore.useDefaultPatterns` is true)
 
 Example of `.repomixignore`:
 ```text

website/client/src/ja/guide/command-line-options.md

@@ -24,6 +24,7 @@
 
 ## フィルターオプション
 - `--include <patterns>`: 含めるパターン（カンマ区切り）
+- `--force-include <patterns>`: 除外ルールを上書きして強制的に含めるパターン（カンマ区切り）
 - `-i, --ignore <patterns>`: 除外パターン（カンマ区切り）
 - `--no-gitignore`: .gitignoreファイルの使用を無効化
 - `--no-default-patterns`: デフォルトパターンを無効化
@@ -69,6 +70,9 @@ repomix --compress
 # 特定のファイルを処理
 repomix --include "src/**/*.ts" --ignore "**/*.test.ts"
 
+# 除外ルールを無視して特定のファイルを強制的に含める
+repomix --force-include "coverage/summary.json,test-results/junit.xml"
+
 # ブランチを指定したリモートリポジトリ
 repomix --remote https://github.com/user/repo/tree/main
 

website/client/src/ja/guide/configuration.md

@@ -99,6 +99,7 @@ repomix --init --global
     }
   },
   "include": ["**/*"],
+  "forceInclude": ["coverage/summary.json", "test-results/junit.xml"],
   "ignore": {
     "useGitignore": true,
     "useDefaultPatterns": true,
@@ -131,10 +132,11 @@ Repomixは以下の順序で設定ファイルを探します：
 
 Repomixは複数の方法でファイルの除外を指定できます。パターンは以下の優先順位で処理されます：
 
-1. CLIオプション（`--ignore`）
-2. プロジェクトディレクトリの`.repomixignore`ファイル
-3. `.gitignore`および`.git/info/exclude`（`ignore.useGitignore`がtrueの場合）
-4. デフォルトパターン（`ignore.useDefaultPatterns`がtrueの場合）
+1. 強制的に含めるパターン（`--force-include`）
+2. CLIオプション（`--ignore`）
+3. プロジェクトディレクトリの`.repomixignore`ファイル
+4. `.gitignore`および`.git/info/exclude`（`ignore.useGitignore`がtrueの場合）
+5. デフォルトパターン（`ignore.useDefaultPatterns`がtrueの場合）
 
 `.repomixignore`の例：
 ```text
@@ -216,4 +218,4 @@ dist/**
 - トークン数を削減したい場合
 - コードの構造とロジックに集中したい場合
 
-サポートされている言語と詳細な例については[コメント削除ガイド](comment-removal)をご覧ください。
+サポートされている言語と詳細な例については[コメント削除ガイド](comment-removal)をご覧ください。