Gather project context for LLMs — intelligently scan repositories and format for AI consumption.
When working with AI coding assistants, you often need to share your project's context. Manually copying files is tedious and error-prone. cli-repo-to-prompt intelligently scans your codebase, respects .gitignore, filters out noise, and formats everything into clean Markdown ready for LLMs.
- 📁 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
# Run instantly with npx (no install)
npx cli-repo-to-prompt
# Or install globally
pnpm add -g cli-repo-to-promptAfter global install, use any of these aliases:
cli-repo-to-prompt .
repo-to-prompt .
context .
llmcontext .
repocp .# Scan current directory → clipboard
npx cli-repo-to-prompt
# Scan specific folder
npx cli-repo-to-prompt ./src
# Scan GitHub repo
npx cli-repo-to-prompt owner/repo
# Write to file
npx cli-repo-to-prompt -o context.md
# Preview what will be included
npx cli-repo-to-prompt --preview# Current directory to clipboard
cli-repo-to-prompt
# Specific directory
cli-repo-to-prompt ./backend
# Output to file
cli-repo-to-prompt -o output.md
# Print to stdout
cli-repo-to-prompt --stdout# Clone and scan
cli-repo-to-prompt facebook/react
# Specific branch
cli-repo-to-prompt vercel/next.js@canary
# Full URL
cli-repo-to-prompt https://github.com/microsoft/typescript# Include only Python files
cli-repo-to-prompt --include "*.py" --include-only
# Exclude test files
cli-repo-to-prompt --exclude "*.test.ts" --exclude "*.spec.ts"
# Include data files (off by default)
cli-repo-to-prompt --include-json --include-yaml --include-markdown
# Limit depth
cli-repo-to-prompt --max-depth 3# Preview files (no content)
cli-repo-to-prompt --preview
# Dry run (stats only)
cli-repo-to-prompt --dry-run
# JSON format
cli-repo-to-prompt --format json
# Show stats with output
cli-repo-to-prompt --show-stats| 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 |
| 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 |
| 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 |
| Option | Description |
|---|---|
--no-gitignore |
Ignore .gitignore |
--use-git |
Only include git-tracked files |
| Option | Description |
|---|---|
--preview |
Preview files without content |
--dry-run |
Show stats only |
--interactive |
Interactive configuration |
--sort-alpha |
Sort alphabetically |
--check-updates |
Check for updates |
# 📁 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...
\`\`\`- Node.js 18+
- git (for GitHub cloning)
MIT © Yigit Konur