A powerful CLI tool that automatically discovers and bundles related source code into a single markdown file, perfect for sharing with LLMs like ChatGPT, Claude, or Cursor AI.

ScanEx = Scan and Export - because that's exactly what it does! 🎯

I wrote this project because I wanted to copy and paste source code quickly to ask LLMs for help.

While coding with Cursor, or when I want to ask something about my implementation on ChatGPT or Google AI Studio, I have to copy related source code way too many times. I have to search and copy a lot of files manually.

So I decided to implement something where I can just point to a file, and it will automatically scan related files and write it out for me.

That's it. Simple problem, simple solution. Now instead of spending 10 minutes copying files, I just run one command and get everything I need. 🎯

• 🔍 Smart Dependency Detection - Uses tree-sitter to analyze actual imports/requires
• 📁 Directory Tree Visualization - Shows your project structure at a glance
• 🚀 Multi-Language Support - Works with 13+ programming languages
• ⚡ Fast & Efficient - Lightning-fast dependency resolution
• 🙈 Respects .gitignore - Automatically excludes ignored files
• 🔧 TypeScript/JavaScript Aliases - Resolves path aliases from tsconfig.json
• 🐚 Unix-friendly - Pipes naturally with other command-line tools
• 📋 Copy-Ready - Perfect for pasting into AI chat interfaces

npm install -g scanex

# Analyze current directory and copy to clipboard (macOS)
scanex | pbcopy

# Save analysis to a file
scanex > my-project.md

# Analyze specific files
scanex --input src/main.js > analysis.md

# Analyze directory with custom output
scanex --input src/ --output docs/codebase.md

# Quick copy for ChatGPT/Claude
scanex --input src/components/UserForm.tsx | pbcopy

# Analyze a bug and share context
scanex --input src/utils/api.js --exclude "test|spec" > bug-report.md

# Create comprehensive project documentation
scanex --exclude "node_modules|dist|build" > PROJECT_OVERVIEW.md

# Focus on specific modules
scanex --input src/auth/ > auth-module-docs.md

# Include all related files for a bug report
scanex --input src/problematic-file.js > bug-context.md

scanex [options]

# Analyze entire project
scanex

# Analyze specific directory
scanex --input src/

# Exclude test files and build artifacts  
scanex --exclude "test|spec|dist|build|node_modules"

# Analyze single file and its dependencies
scanex --input src/main.js

# Analyze multiple specific files
scanex --input src/api.js,src/utils.js,src/types.ts

# Unix-style piping
scanex | grep "function" | head -20

# Combine with other tools
scanex --input src/ | wc -l  # Count lines

# Save to custom location
scanex --input backend/ --output docs/backend-analysis.md

ScanEx intelligently analyzes dependencies across multiple languages:

ScanEx generates clean, structured markdown:

<directory_tree>
.
├── src/
│   ├── components/
│   │   ├── Header.tsx
│   │   └── Footer.tsx
│   ├── utils/
│   │   └── api.ts
│   └── main.ts
└── package.json
</directory_tree>

<codebase>

#### `src/main.ts`
```typescript
import { Header } from './components/Header';
import { apiCall } from './utils/api';
// ... rest of the code
```

#### `src/components/Header.tsx`
```tsx
import React from 'react';
// ... component code
```

</codebase>

ScanEx automatically detects and resolves path aliases from:

• tsconfig.json
• jsconfig.json

Example tsconfig.json:

{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@/*": ["src/*"],
      "@components/*": ["src/components/*"]
    }
  }
}

ScanEx automatically respects .gitignore files at any level in your project, so you don't need to worry about including:

• node_modules/
• Build artifacts (dist/, build/)
• IDE files (.vscode/, .idea/)
• OS files (.DS_Store)

ScanEx intelligently detects your project root by looking for:

1. Git repository (.git directory)
2. Package files (package.json, pyproject.toml, Cargo.toml, etc.)
3. Fallback to input directory

• Tree-sitter parsing for accurate import detection
• Path alias resolution for TypeScript/JavaScript projects
• Relative import handling across all languages
• Circular dependency detection and handling

We welcome contributions! Please feel free to submit a Pull Request.

# Clone the repository
git clone https://github.com/darkamenosa/scanex.git
cd scanex

# Install dependencies
npm install

# Run locally
node bin/scanex.js --help

This project is licensed under the MIT License - see the LICENSE file for details.

• Built with tree-sitter for accurate code parsing
• Inspired by the need for better AI-human collaboration in coding
• Thanks to the open-source community for language grammar definitions

Made with ❤️ for developers who love AI-assisted coding

ScanEx - Because your AI deserves better context 🚀