feat(cli): Add --stdin flag to read file list from stdin

[yamadashy]

Implements the --stdin feature requested in issue #648, allowing users to pipe file lists from tools like fd and ripgrep.

Changes

• Add --stdin CLI option and type definition
• Create fileStdin.ts for reading file paths from stdin
• Modify defaultAction.ts to handle stdin mode by overriding searchFiles
• Add semantic suggestions for related terms (input, pipe → --stdin)
• Validate that directory arguments are not used with --stdin

Usage Examples

# List all Markdown files
fd -t file -e md | repomix --stdin

# List files from "tests" directories
fd -t directory 'tests' | repomix --stdin

# Find TS files containing 'MyClass' pattern
fd -t file -e ts -e tsx --exec-batch rg -l 'MyClass' | repomix --stdin

Closes #648

Generated with Claude Code

[coderabbitai]

Important

Review skipped

Auto incremental reviews are disabled on this repository.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Walkthrough

Support for reading file paths from standard input (stdin) was added to the CLI via a new --stdin flag. The CLI options, action handler, and types were updated accordingly. A new module implements the logic to read and validate file paths from stdin, which is invoked when the flag is present.

Changes

File(s)	Change Summary
src/cli/actions/defaultAction.ts	Added logic to handle --stdin, invoking file path reading from stdin and integrating with the packing process.
src/cli/cliRun.ts	Registered the --stdin CLI option and updated semantic suggestions for related input terms.
src/cli/types.ts	Extended CliOptions interface to include an optional stdin boolean property.
src/core/file/fileStdin.ts	Introduced new module with readFilePathsFromStdin to read and validate file paths from stdin.

Sequence Diagram(s)

sequenceDiagram
    participant User
    participant CLI
    participant fileStdin
    participant packer

    User->>CLI: repomix --stdin
    CLI->>CLI: Parse CLI options (detect --stdin)
    CLI->>fileStdin: readFilePathsFromStdin(cwd)
    fileStdin-->>CLI: { filePaths, emptyDirPaths }
    CLI->>packer: pack({ searchFiles: returns stdin filePaths })
    packer-->>CLI: Pack result
    CLI->>User: Output summary and results

Loading

Assessment against linked issues

Objective (Issue #)	Addressed	Explanation
Add support for reading the file list from stdin (#648)	✅

Assessment against linked issues: Out-of-scope changes

No out-of-scope changes found.

Possibly related PRs

• Allow for passing in multiple directories #338: Both PRs modify runDefaultAction to handle new input modes, with this PR focusing on stdin and the related PR on multiple directory input.

✨ Finishing Touches

🧪 Generate Unit Tests

• Create PR with Unit Tests
• Commit Unit Tests in branch claude/issue-648-20250613_024248
• Post Copyable Unit Tests in Comment

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

‼️ IMPORTANT
Auto-reply has been disabled for this repository in the CodeRabbit settings. The CodeRabbit bot will not respond to your replies unless it is explicitly tagged.

• Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
  • @coderabbitai explain this code block.
  • @coderabbitai modularize this function.
• PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
  • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
  • @coderabbitai read src/utils.ts and explain its main purpose.
  • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
  • @coderabbitai help me debug CodeRabbit configuration file.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

• @coderabbitai pause to pause the reviews on a PR.
• @coderabbitai resume to resume the paused reviews.
• @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
• @coderabbitai full review to do a full review from scratch and review all the files again.
• @coderabbitai summary to regenerate the summary of the PR.
• @coderabbitai generate docstrings to generate docstrings for this PR.
• @coderabbitai generate sequence diagram to generate a sequence diagram of the changes in this PR.
• @coderabbitai auto-generate unit tests to generate unit tests for this PR.
• @coderabbitai resolve resolve all the CodeRabbit review comments.
• @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
• @coderabbitai help to get help.

Other keywords and placeholders

• Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
• Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
• Add @coderabbitai anywhere in the PR title to generate the title automatically.

Documentation and Community

• Visit our Documentation for detailed information on how to use CodeRabbit.
• Join our Discord Community to get help, request features, and share feedback.
• Follow us on X/Twitter for updates and announcements.

[gemini-code-assist]

Summary of Changes

Hello @yamadashy, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request implements a new feature allowing the tool to accept a list of file paths via standard input using the --stdin flag. This enhances flexibility by enabling integration with other command-line tools like fd or ripgrep for generating the list of files to process. The changes involve adding the CLI option, creating dedicated logic for reading from stdin, and modifying the main action to handle this new input method.

Highlights

• New CLI Option: Introduced the --stdin flag to the CLI, allowing users to pipe lists of file paths directly into the tool instead of relying on filesystem traversal.
• Stdin File Reading Logic: Added a new module (src/core/file/fileStdin.ts) responsible for reading file paths line by line from standard input, handling relative/absolute paths, and filtering comments/empty lines.
• Integration into Default Action: Modified the main runDefaultAction to detect the --stdin flag. When present, it reads files from stdin and overrides the internal file search mechanism to use the provided list, bypassing the standard directory traversal.
• Argument Validation: Added validation to prevent using directory arguments (other than the default '.') when the --stdin flag is active, ensuring clear usage.
• Semantic Suggestions: Added 'input' and 'pipe' as semantic suggestions in the CLI parser to guide users towards the new --stdin option if they type related terms.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point in your pull request via creating an issue comment (i.e. comment on the pull request page) using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in issue comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist is currently in preview and may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments to provide feedback.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configureGemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

[codecov]

Codecov Report

Attention: Patch coverage is 96.63866% with 4 lines in your changes missing coverage. Please review.

Project coverage is 90.50%. Comparing base (02b182d) to head (8a4b641).
Report is 16 commits behind head on main.

Files with missing lines	Patch %	Lines
src/cli/actions/defaultAction.ts	93.33%	4 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #653      +/-   ##
==========================================
+ Coverage   90.38%   90.50%   +0.11%     
==========================================
  Files          96       97       +1     
  Lines        5024     5139     +115     
  Branches     1052     1080      +28     
==========================================
+ Hits         4541     4651     +110     
- Misses        483      488       +5     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[gemini-code-assist]

Code Review

This pull request introduces a valuable --stdin flag, enabling users to pipe file lists directly into repomix. The implementation for reading and processing stdin input is robust. Key feedback points include addressing code duplication in the main action handler, refining an error message, and removing an unused import.

[coderabbitai]

Actionable comments posted: 1

🧹 Nitpick comments (5)

src/core/file/fileStdin.ts (3)

1-1: Remove unused import to avoid dead-code noise

readFile is imported but never referenced.
Cleaning this up prevents misleading editors / linters.

-import { readFile } from 'node:fs/promises';

---

24-34: Stream input line-by-line to keep memory bounded

Accumulating the whole stdin into one big string (data += chunk) risks high RAM usage when very large file lists are piped in.
Using readline to process lines incrementally is more scalable:

-  let data = '';
-  …
-  for await (const chunk of stdin) {
-    data += chunk;
-  }
-  …
-  const lines = data.split('\n')
+  import readline from 'node:readline/promises';
+  const rl = readline.createInterface({ input: stdin });
+  const lines: string[] = [];
+  for await (const line of rl) {
+    const trimmed = line.trim();
+    if (trimmed && !trimmed.startsWith('#')) lines.push(trimmed);
+  }

🧰 Tools

🪛 GitHub Check: codecov/patch

[warning] 24-24: src/core/file/fileStdin.ts#L24
Added line #L24 was not covered by tests

---

[warning] 27-29: src/core/file/fileStdin.ts#L27-L29
Added lines #L27 - L29 were not covered by tests

---

[warning] 32-34: src/core/file/fileStdin.ts#L32-L34
Added lines #L32 - L34 were not covered by tests

---

50-54: Deduplicate & normalise resolved paths

If the same path appears twice on stdin it will be processed twice.
Also, path.normalize helps collapse ../ segments.

-const filePaths = lines.map(line => {
-  const filePath = path.isAbsolute(line) ? line : path.resolve(cwd, line);
-  logger.trace(`Resolved path: ${line} -> ${filePath}`);
-  return filePath;
-});
+const filePaths = [
+  ...new Set(
+    lines.map((line) => {
+      const filePath = path.isAbsolute(line)
+        ? path.normalize(line)
+        : path.normalize(path.resolve(cwd, line));
+      logger.trace(`Resolved path: ${line} -> ${filePath}`);
+      return filePath;
+    }),
+  ),
+];

🧰 Tools

🪛 GitHub Check: codecov/patch

[warning] 50-54: src/core/file/fileStdin.ts#L50-L54
Added lines #L50 - L54 were not covered by tests

src/cli/cliRun.ts (1)

85-85: Consider documenting conflicts for clearer UX

--stdin cannot meaningfully coexist with positional directory args (handled later) but Commander can surface this earlier:

-.option('--stdin', 'read file list from stdin')
+.addOption(new Option('--stdin', 'read file list from stdin').conflicts(['remote']))

(Replace the list with any options you deem mutually exclusive.)

src/cli/actions/defaultAction.ts (1)

66-73: Normalize relative paths once to keep OS separators consistent

path.relative returns back-slashes on Windows; downstream code might assume POSIX separators.
Normalise to forward slashes when building the list:

-filePaths: stdinResult.filePaths.map(filePath => path.relative(cwd, filePath)),
+filePaths: stdinResult.filePaths.map((p) =>
+  path.relative(cwd, p).split(path.sep).join('/'),
+),

🧰 Tools

🪛 GitHub Check: codecov/patch

[warning] 66-77: src/cli/actions/defaultAction.ts#L66-L77
Added lines #L66 - L77 were not covered by tests

📜 Review details

Configuration used: .coderabbit.yaml
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 0d0f20e and f779f02.

📒 Files selected for processing (4)

• src/cli/actions/defaultAction.ts (2 hunks)
• src/cli/cliRun.ts (2 hunks)
• src/cli/types.ts (1 hunks)
• src/core/file/fileStdin.ts (1 hunks)

🧰 Additional context used

🧬 Code Graph Analysis (1)

src/core/file/fileStdin.ts (2)

src/shared/logger.ts (2)

• logger (88-88)
• error (33-37)

src/shared/errorHandle.ts (1)

• RepomixError (5-10)

🪛 GitHub Check: codecov/patch

src/cli/actions/defaultAction.ts

[warning] 51-53: src/cli/actions/defaultAction.ts#L51-L53
Added lines #L51 - L53 were not covered by tests

---

[warning] 55-56: src/cli/actions/defaultAction.ts#L55-L56
Added lines #L55 - L56 were not covered by tests

---

[warning] 58-58: src/cli/actions/defaultAction.ts#L58
Added line #L58 was not covered by tests

---

[warning] 60-61: src/cli/actions/defaultAction.ts#L60-L61
Added lines #L60 - L61 were not covered by tests

---

[warning] 63-63: src/cli/actions/defaultAction.ts#L63
Added line #L63 was not covered by tests

---

[warning] 66-77: src/cli/actions/defaultAction.ts#L66-L77
Added lines #L66 - L77 were not covered by tests

---

[warning] 79-80: src/cli/actions/defaultAction.ts#L79-L80
Added lines #L79 - L80 were not covered by tests

---

[warning] 82-90: src/cli/actions/defaultAction.ts#L82-L90
Added lines #L82 - L90 were not covered by tests

---

[warning] 92-93: src/cli/actions/defaultAction.ts#L92-L93
Added lines #L92 - L93 were not covered by tests

---

[warning] 95-96: src/cli/actions/defaultAction.ts#L95-L96
Added lines #L95 - L96 were not covered by tests

---

[warning] 98-98: src/cli/actions/defaultAction.ts#L98
Added line #L98 was not covered by tests

---

[warning] 100-104: src/cli/actions/defaultAction.ts#L100-L104
Added lines #L100 - L104 were not covered by tests

src/core/file/fileStdin.ts

[warning] 17-17: src/core/file/fileStdin.ts#L17
Added line #L17 was not covered by tests

---

[warning] 19-19: src/core/file/fileStdin.ts#L19
Added line #L19 was not covered by tests

---

[warning] 21-22: src/core/file/fileStdin.ts#L21-L22
Added lines #L21 - L22 were not covered by tests

---

[warning] 24-24: src/core/file/fileStdin.ts#L24
Added line #L24 was not covered by tests

---

[warning] 27-29: src/core/file/fileStdin.ts#L27-L29
Added lines #L27 - L29 were not covered by tests

---

[warning] 32-34: src/core/file/fileStdin.ts#L32-L34
Added lines #L32 - L34 were not covered by tests

---

[warning] 36-38: src/core/file/fileStdin.ts#L36-L38
Added lines #L36 - L38 were not covered by tests

---

[warning] 41-43: src/core/file/fileStdin.ts#L41-L43
Added lines #L41 - L43 were not covered by tests

---

[warning] 45-47: src/core/file/fileStdin.ts#L45-L47
Added lines #L45 - L47 were not covered by tests

---

[warning] 50-54: src/core/file/fileStdin.ts#L50-L54
Added lines #L50 - L54 were not covered by tests

---

[warning] 56-56: src/core/file/fileStdin.ts#L56
Added line #L56 was not covered by tests

---

[warning] 58-65: src/core/file/fileStdin.ts#L58-L65
Added lines #L58 - L65 were not covered by tests

---

[warning] 67-69: src/core/file/fileStdin.ts#L67-L69
Added lines #L67 - L69 were not covered by tests

---

[warning] 71-73: src/core/file/fileStdin.ts#L71-L73
Added lines #L71 - L73 were not covered by tests

⏰ Context from checks skipped due to timeout of 90000ms (19)

• GitHub Check: Test (macos-latest, 22.x)
• GitHub Check: Test (windows-latest, 24.x)
• GitHub Check: Test (windows-latest, 22.x)
• GitHub Check: Test (windows-latest, 23.x)
• GitHub Check: Build and run (macos-latest, 19.x)
• GitHub Check: Test (windows-latest, 19.x)
• GitHub Check: Build and run (macos-latest, 24.x)
• GitHub Check: Test (windows-latest, 20.x)
• GitHub Check: Test (ubuntu-latest, 18.0.0)
• GitHub Check: Test (ubuntu-latest, 21.x)
• GitHub Check: Test (ubuntu-latest, 19.x)
• GitHub Check: Build and run (windows-latest, 24.x)
• GitHub Check: Build and run (windows-latest, 23.x)
• GitHub Check: Build and run (windows-latest, 20.x)
• GitHub Check: Build and run (windows-latest, 18.x)
• GitHub Check: Build and run (windows-latest, 21.x)
• GitHub Check: Build and run (windows-latest, 19.x)
• GitHub Check: Build and run (windows-latest, 18.0.0)
• GitHub Check: Analyze (javascript-typescript)

🔇 Additional comments (2)

src/cli/types.ts (1)

32-32: LGTM – new stdin flag is correctly typed

The optional boolean integrates cleanly with the existing options interface.

src/cli/cliRun.ts (1)

45-46: Good semantic hints for discoverability

Adding "input" and "pipe" → --stdin helps users find the flag intuitively.

[cloudflare-workers-and-pages]

Deploying repomix with    Cloudflare Pages

Latest commit:	8a4b641
Status:	✅  Deploy successful!
Preview URL:	https://7ac99c3b.repomix.pages.dev
Branch Preview URL:	https://claude-issue-648-20250613-02.repomix.pages.dev

View logs

[Copilot]

Pull Request Overview

Implements a new --stdin flag to let users pipe a list of file paths into the CLI instead of auto-discovering them.

• Defines a stdin boolean option in the CLI schema and parsing layer
• Adds a new fileStdin.ts module with stdin-reading, filtering, resolution, and deduplication logic, plus tests
• Updates defaultAction.ts to route through a handleStdinProcessing workflow and adjusts documentation across all languages

Reviewed Changes

Copilot reviewed 31 out of 31 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
src/cli/types.ts	Added stdin?: boolean to the CliOptions interface
src/cli/cliRun.ts	Declared the --stdin option and semantic suggestion mapping
src/core/file/fileStdin.ts	New module for reading, filtering, resolving, and deduping stdin file lists
src/cli/actions/defaultAction.ts	Introduced handleStdinProcessing, updated action routing
tests/core/file/fileStdin.test.ts	Tests for filtering, resolution, error handling on stdin input
tests/cli/actions/defaultAction.test.ts	Tests for the new stdin processing path in the default action
website/client/src/**/guide/command-line-options.md	Updated docs in all locales to include the --stdin option
website/client/src/**/guide/usage.md	Added usage snippets demonstrating piping file lists via stdin
README.md	Added examples and option description for --stdin

Comments suppressed due to low confidence (1)

website/client/src/hi/guide/command-line-options.md:77

• [nitpick] The initial 'Stdin से फ़ाइल पथ' snippet is redundant since a full usage example is already provided later. Consider removing lines 77–84 to keep this guide consistent with other languages.

### Stdin से फ़ाइल पथ