add stdin content option

Author: Samsen879

README.md

@@ -276,6 +276,18 @@ When using `--stdin`, the specified files are effectively added to the include p
 > [!NOTE]
 > When using `--stdin`, file paths can be relative or absolute, and Repomix will automatically handle path resolution and deduplication.
 
+To include command output or other ad-hoc context near the top of the packed output:
+
+```bash
+# Include build output in the generated Repomix file
+npm run build 2>&1 | repomix --stdin-content
+
+# Include recent logs in the generated Repomix file
+tail -n 200 app.log | repomix --stdin-content
+```
+
+The `--stdin-content` option reads arbitrary stdin text and places it after the header section, before the directory structure. Use it when you want to package current error output, logs, or other runtime context together with the codebase. It cannot be combined with `--stdin`.
+
 To include git logs in the output:
 
 ```bash
@@ -616,6 +628,7 @@ Instruction
 | `--quiet` | Suppress all console output except errors (useful for scripting) |
 | `--stdout` | Write packed output directly to stdout instead of a file (suppresses all logging) |
 | `--stdin` | Read file paths from stdin, one per line (specified files are processed directly) |
+| `--stdin-content` | Read arbitrary stdin content and include it near the top of the packed output |
 | `--copy` | Copy the generated output to system clipboard after processing |
 | `--token-count-tree [threshold]` | Show file tree with token counts; optional threshold to show only files with ≥N tokens (e.g., `--token-count-tree 100`) |
 | `--top-files-len <number>` | Number of largest files to show in summary (default: `5`) |
@@ -692,7 +705,7 @@ Instruction
 #### Watch Mode
 - `-w, --watch`: Watch for file changes and automatically re-pack. Debounces rapid changes (300ms) and logs a timestamp on each rebuild. Stop with `Ctrl+C`.
 
-  Watch mode only works with local directories, so it cannot be combined with `--remote`, a positional remote repository URL, `--stdout`, `--stdin`, `--split-output`, `--skill-generate`, or `--copy` (whether set on the command line or in your config file).
+  Watch mode only works with local directories, so it cannot be combined with `--remote`, a positional remote repository URL, `--stdout`, `--stdin`, `--stdin-content`, `--split-output`, `--skill-generate`, or `--copy` (whether set on the command line or in your config file).
 
 #### Examples
 

src/cli/actions/defaultAction.ts

@@ -8,7 +8,7 @@ import {
   type RepomixOutputStyle,
   repomixConfigCliSchema,
 } from '../../config/configSchema.js';
-import { readFilePathsFromStdin } from '../../core/file/fileStdin.js';
+import { readContentFromStdin, readFilePathsFromStdin } from '../../core/file/fileStdin.js';
 import { type PackResult, pack } from '../../core/packager.js';
 import { generateDefaultSkillName } from '../../core/skill/skillUtils.js';
 import { RepomixError, rethrowValidationErrorIfSchemaError } from '../../shared/errorHandle.js';
@@ -61,6 +61,10 @@ export const runDefaultAction = async (
 ): Promise<DefaultActionRunnerResult> => {
   logger.trace('Loaded CLI options:', cliOptions);
 
+  if (cliOptions.stdinContent === true) {
+    cliOptions.stdinContent = await readContentFromStdin();
+  }
+
   // Build the merged config (migration + file config + CLI options)
   const config = await buildMergedConfig(cwd, cliOptions);
 
@@ -284,6 +288,10 @@ export const buildCliConfig = (options: CliOptions): RepomixConfigCli => {
     cliConfig.output = { ...cliConfig.output, headerText: options.headerText };
   }
 
+  if (typeof options.stdinContent === 'string') {
+    cliConfig.output = { ...cliConfig.output, stdinContent: options.stdinContent };
+  }
+
   if (options.compress !== undefined) {
     cliConfig.output = { ...cliConfig.output, compress: options.compress };
   }

src/cli/cliRun.ts

@@ -73,6 +73,12 @@ export const run = async () => {
         ).conflicts('output'),
       )
       .option('--stdin', 'Read file paths from stdin, one per line (specified files are processed directly)')
+      .addOption(
+        new Option(
+          '--stdin-content',
+          'Read arbitrary stdin content and include it near the top of the packed output',
+        ).conflicts('stdin'),
+      )
       .option('--copy', 'Copy the generated output to system clipboard after processing')
       .option(
         '--token-count-tree [threshold]',
@@ -260,6 +266,9 @@ const validateWatchOptions = (directories: string[], options: CliOptions): void
   if (options.stdin) {
     throw new RepomixError('--watch cannot be used with --stdin. Watch mode discovers files automatically.');
   }
+  if (options.stdinContent) {
+    throw new RepomixError('--watch cannot be used with --stdin-content. Watch mode discovers files automatically.');
+  }
   if (options.copy) {
     throw new RepomixError(
       '--watch cannot be used with --copy. Watch mode re-packs on every change, which would repeatedly overwrite the clipboard.',
@@ -291,6 +300,10 @@ export const runCli = async (directories: string[], cwd: string, options: CliOpt
   // Validate --watch conflicts early, before log level changes can suppress error messages
   validateWatchOptions(directories, options);
 
+  if (options.stdin && options.stdinContent) {
+    throw new RepomixError('--stdin cannot be used with --stdin-content. Both options consume standard input.');
+  }
+
   // Set log level based on verbose and quiet flags
   if (options.quiet) {
     logger.setLogLevel(repomixLogLevels.SILENT);

src/cli/types.ts

@@ -36,6 +36,7 @@ export interface CliOptions extends OptionValues {
   dotIgnore?: boolean;
   defaultPatterns?: boolean;
   stdin?: boolean;
+  stdinContent?: boolean | string;
 
   // Remote Repository Options
   remote?: string;

src/config/configSchema.ts

@@ -136,6 +136,7 @@ export const repomixConfigCliSchema = v.intersect([
     output: v.optional(
       v.object({
         stdout: v.optional(v.boolean()),
+        stdinContent: v.optional(v.string()),
       }),
     ),
     skillGenerate: v.optional(v.union([v.string(), v.boolean()])),

src/core/file/fileStdin.ts

@@ -114,3 +114,42 @@ export const readFilePathsFromStdin = async (
     throw new RepomixError('An unexpected error occurred while reading from stdin.');
   }
 };
+
+/**
+ * Reads arbitrary text content from stdin, preserving blank lines.
+ */
+export const readContentFromStdin = async (
+  deps: StdinDependencies = {
+    stdin: process.stdin,
+    createReadlineInterface: readline.createInterface,
+  },
+): Promise<string> => {
+  logger.trace('Reading content from stdin...');
+
+  try {
+    const { stdin } = deps;
+
+    if (stdin.isTTY) {
+      throw new RepomixError(
+        'No data provided via stdin. Please pipe content to repomix when using --stdin-content flag.',
+      );
+    }
+
+    const chunks: Buffer[] = [];
+    for await (const chunk of stdin as Readable) {
+      chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    }
+
+    return Buffer.concat(chunks).toString('utf8');
+  } catch (error) {
+    if (error instanceof RepomixError) {
+      throw error;
+    }
+
+    if (error instanceof Error) {
+      throw new RepomixError(`Failed to read content from stdin: ${error.message}`);
+    }
+
+    throw new RepomixError('An unexpected error occurred while reading content from stdin.');
+  }
+};

src/core/output/outputGenerate.ts

@@ -86,6 +86,7 @@ export const createRenderContext = (outputGeneratorContext: OutputGeneratorConte
     ),
     summaryNotes: generateSummaryNotes(outputGeneratorContext.config),
     headerText: outputGeneratorContext.config.output.headerText,
+    stdinContent: outputGeneratorContext.config.output.stdinContent,
     instruction: outputGeneratorContext.instruction,
     treeString: outputGeneratorContext.treeString,
     processedFiles: outputGeneratorContext.processedFiles,
@@ -123,6 +124,7 @@ const generateParsableXmlOutput = async (renderContext: RenderContext): Promise<
           }
         : undefined,
       user_provided_header: renderContext.headerText,
+      stdin_content: renderContext.stdinContent,
       directory_structure: renderContext.directoryStructureEnabled ? renderContext.treeString : undefined,
       files: renderContext.filesEnabled
         ? {
@@ -175,6 +177,9 @@ const generateParsableJsonOutput = async (renderContext: RenderContext): Promise
     ...(renderContext.headerText && {
       userProvidedHeader: renderContext.headerText,
     }),
+    ...(renderContext.stdinContent && {
+      stdinContent: renderContext.stdinContent,
+    }),
     ...(renderContext.directoryStructureEnabled && {
       directoryStructure: renderContext.treeString,
     }),

src/core/output/outputGeneratorTypes.ts

@@ -20,6 +20,7 @@ export interface RenderContext {
   readonly summaryUsageGuidelines: string;
   readonly summaryNotes: string;
   readonly headerText: string | undefined;
+  readonly stdinContent?: string;
   readonly instruction: string;
   readonly treeString: string;
   readonly processedFiles: ReadonlyArray<ProcessedFile>;

src/core/output/outputStyles/markdownStyle.ts

@@ -30,6 +30,11 @@ export const getMarkdownTemplate = () => {
 # User Provided Header
 {{{headerText}}}
 
+{{/if}}
+{{#if stdinContent}}
+# Standard Input Content
+{{{stdinContent}}}
+
 {{/if}}
 {{#if directoryStructureEnabled}}
 # Directory Structure

src/core/output/outputStyles/plainStyle.ts

@@ -40,6 +40,13 @@ User Provided Header
 ${PLAIN_LONG_SEPARATOR}
 {{{headerText}}}
 
+{{/if}}
+{{#if stdinContent}}
+${PLAIN_LONG_SEPARATOR}
+Standard Input Content
+${PLAIN_LONG_SEPARATOR}
+{{{stdinContent}}}
+
 {{/if}}
 {{#if directoryStructureEnabled}}
 ${PLAIN_LONG_SEPARATOR}