cli-repotoprompt

Gather project context for LLMs — intelligently scan repositories and format for AI consumption.

Why?

When working with AI coding assistants, you often need to share your project's context. Manually copying files is tedious and error-prone. repo-to-prompt intelligently scans your codebase, respects .gitignore, filters out noise, and formats everything into clean Markdown ready for LLMs.

Features

• 📁 Smart Scanning — Respects .gitignore, skips binaries, build artifacts, and node_modules
• 🐙 GitHub Support — Clone and scan any public repository directly
• 📋 Clipboard Ready — Copies to clipboard by default, ready to paste
• 🌲 Tree Visualization — Beautiful project structure display
• 🔍 Tech Detection — Automatically detects your stack
• ⚡ Fast — Built on native ESM with fast-glob

Installation

# Run instantly with npx (no install)
npx cli-repotoprompt

# Or install globally
npm install -g cli-repotoprompt

After global install, use any of these aliases:

repo-to-prompt .
context .
llmcontext .
repocp .

Quick Start

# Scan current directory → clipboard
npx cli-repotoprompt

# Scan specific folder
npx cli-repotoprompt ./src

# Scan GitHub repo
npx cli-repotoprompt owner/repo

# Write to file
npx cli-repotoprompt -o context.md

# Preview what will be included
npx cli-repotoprompt --preview

Usage Examples

Basic

# Current directory to clipboard
repo-to-prompt

# Specific directory
repo-to-prompt ./backend

# Output to file
repo-to-prompt -o output.md

# Print to stdout
repo-to-prompt --stdout

GitHub Repositories

# Clone and scan
repo-to-prompt facebook/react

# Specific branch
repo-to-prompt vercel/next.js@canary

# Full URL
repo-to-prompt https://github.com/microsoft/typescript

Filtering

# Include only Python files
repo-to-prompt --include "*.py" --include-only

# Exclude test files
repo-to-prompt --exclude "*.test.ts" --exclude "*.spec.ts"

# Include data files (off by default)
repo-to-prompt --include-json --include-yaml --include-markdown

# Limit depth
repo-to-prompt --max-depth 3

Output Control

# Preview files (no content)
repo-to-prompt --preview

# Dry run (stats only)
repo-to-prompt --dry-run

# JSON format
repo-to-prompt --format json

# Show stats with output
repo-to-prompt --show-stats

Options

Output

| Option | Description | |--------|-------------| | -o, --output <file> | Write to file | | --stdout | Print to stdout | | --no-clipboard | Don't copy to clipboard | | --format <type> | markdown (default) or json |

Filtering

| Option | Description | |--------|-------------| | --include <pattern> | Include glob pattern | | --exclude <pattern> | Exclude glob pattern | | --include-only | Only include matching patterns | | --max-size <size> | Max file size (default: 2M) | | --max-depth <n> | Max directory depth | | --include-binary | Include binary files |

File Types

| Option | Description | |--------|-------------| | --include-json | Include JSON files | | --include-yaml | Include YAML/YML files | | --include-markdown | Include Markdown files | | --include-html | Include HTML files | | --include-css | Include CSS files | | --include-sql | Include SQL files | | --include-csv | Include CSV files | | --include-xml | Include XML files |

Git

| Option | Description | |--------|-------------| | --no-gitignore | Ignore .gitignore | | --use-git | Only include git-tracked files |

Features

| Option | Description | |--------|-------------| | --preview | Preview files without content | | --dry-run | Show stats only | | --interactive | Interactive configuration | | --sort-alpha | Sort alphabetically | | --check-updates | Check for updates |

Output Example

# 📁 Project Context
*Directory: `~/my-project`*

## Overview
- **Stack:** TypeScript, React
- **Files:** 24
- **Lines:** 2,456

## Structure
.
├── 📁 src
│   ├── 📄 index.ts (50L)
│   └── 📁 components
│       └── 📄 App.tsx (120L)
└── 📄 package.json (30L)

---

## Source Files

### 📘 `src/index.ts`
*50 lines • 1,234 chars*

\`\`\`typescript
// Your code here...
\`\`\`

Requirements

• Node.js 18+
• git (for GitHub cloning)

License

MIT © Yigit Konur