Path Extractor for Claude Code 🚀

Supercharge your Claude Code workflow by referencing multiple files at once!

🎯 Why This Extension?

When working with Claude Code (or other AI coding assistants), referencing multiple files individually can be tedious and inefficient. Based on extensive "trust me bro" internal benchmarking, Claude Code performs significantly better when you reference multiple files in a single batch operation rather than one by one.

This extension solves that problem by instantly extracting all file paths from any folder with the @ prefix format that Claude Code recognizes, allowing you to reference entire codebases or project sections with a single click.

The Problem

// ❌ Slow and tedious:
"@src/components/Header.tsx"
"@src/components/Footer.tsx" 
"@src/components/Sidebar.tsx"
// ... manually typing each path

The Solution

// ✅ One click, all paths:
Right-click folder → Extract Paths → Paste!
@src/components/Header.tsx
@src/components/Footer.tsx
@src/components/Sidebar.tsx
@src/components/Navigation.tsx
@src/components/Card.tsx
// ... all paths instantly!

✨ Features

🖱️ One-Click Extraction: Right-click any folder or file to extract paths
📁 Deep Recursion: Automatically includes all nested folders and subfiles
🎯 Multi-Selection: Select multiple folders/files at once (Ctrl/Cmd+Click)
📋 Instant Clipboard: Paths are copied directly to clipboard - no extra steps
🎯 Claude-Optimized: Uses the @ prefix format for optimal AI file referencing
⚡ Lightning Fast: No UI delays - just instant results
🔧 Zero Config: Works out of the box, no setup required

📦 Installation

From VS Code Marketplace

Open VS Code
Go to Extensions (Ctrl+Shift+X / Cmd+Shift+X)
Search for "Path Extractor Claude"
Click Install

From VSIX (Local Install)

# Clone the repo
git clone https://github.com/Mohamad-Jaallouk/path-extractor-claude
cd path-extractor-vscode

# Install dependencies
npm install

# Package the extension
npm run package

# The .vsix file will be created - install it via VS Code

🚀 Usage

Single Selection

Right-click any folder or file in VS Code Explorer
Select "Extract Paths with @ for Claude"
Paste anywhere (paths are already in your clipboard!)

Multiple Selection

Select multiple items using Ctrl+Click (Cmd+Click on Mac)
Right-click on any selected item
Select "Extract Paths with @ for Claude"
All paths from all selected items are copied to clipboard!

The extension will recursively scan all folders and include all selected files, automatically removing duplicates and sorting alphabetically.

📊 Real-World Example

Working on a Next.js monorepo, right-clicking on the _components folder:

apps/
└── web/
    └── app/
        └── dashboard/
            └── _components/    ← Right-click here
                ├── Header.tsx
                ├── Sidebar.tsx
                └── widgets/
                    └── Chart.tsx

One right-click produces:

@apps/web/app/dashboard/_components/Header.tsx
@apps/web/app/dashboard/_components/Sidebar.tsx
@apps/web/app/dashboard/_components/widgets/Chart.tsx

The extension extracts full relative paths from workspace root, giving AI assistants complete context about your project structure!

Multi-Selection Example

Select multiple folders and files together:

src/
├── components/     ← Ctrl+Click
├── hooks/          ← Ctrl+Click
├── utils/          ← Ctrl+Click
└── types.ts        ← Ctrl+Click

One extraction gives you ALL paths from:

All files in components/ folder
All files in hooks/ folder
All files in utils/ folder
Plus the individual types.ts file

Perfect for when you need to reference multiple related parts of your codebase at once!

🎯 Perfect For

📝 Code Reviews: Reference entire modules for AI review
🐛 Bug Hunting: Share related files for debugging help
♻️ Refactoring: Get suggestions across multiple files
📚 Documentation: Generate docs for entire folders
🔍 Analysis: Analyze patterns across codebases
🎨 Consistency: Check style consistency across files

🛠️ Development

# Clone the repository
git clone https://github.com/Mohamad-Jaallouk/path-extractor-claude
cd path-extractor-vscode

# Install dependencies
npm install

# Run in development mode
# Press F5 in VS Code to launch a test instance

# Package for distribution
npm run package

# Publish to marketplace (requires publisher account)
npm run publish

🤝 Contributing

Contributions are welcome! Feel free to:

🐛 Report bugs
💡 Suggest features
🔧 Submit pull requests

📝 Changelog

See CHANGELOG.md for version history.

📄 License

🙏 Acknowledgments

Inspired by the Claude Code community's need for batch file operations
Built with love for developers using AI coding assistants
Special thanks to the "trust me bro" benchmark methodology 😄

💬 Support

🐛 Report Issues
💡 Request Features
🌟 If this saves you time, consider starring the repo!

Made with ❤️ for the Claude Code community

"Because life's too short to reference files one by one"

Path Extractor for Claude Code

Mohamad Jaallouk