Scope-Replace

Find and replace text across multiple files at once, but only in the files you choose.

VS Code's built-in search can replace across your whole project, which is sometimes too much. Scope-Replace lets you pick exactly which files to change, so nothing else gets touched by accident.

---

Features

• Find and replace across many files in one go
• Select the exact files you want to include
• Preview matches before replacing
• Saves time on repetitive edits
• Works with any file type

Installation

From the Marketplace

1. Open VS Code.
2. Go to the Extensions view (Ctrl+Shift+X, or Cmd+Shift+X on Mac).
3. Search for Scope-Replace.
4. Click Install.

From a VSIX file

1. Download the .vsix file from the Releases page.
2. In VS Code, open the Extensions view.
3. Click the ... menu at the top right and choose Install from VSIX...
4. Select the downloaded file.

How to Use

1. Open the Command Palette (Ctrl+Shift+P, or Cmd+Shift+P on Mac).
2. Run Scope-Replace: Open.
3. Type the text you want to find.
4. Type the text you want to replace it with.
5. Select the files you want to include.
6. Review the matches.
7. Click Replace to apply the changes.

Commands

Command	What it does
Scope-Replace: Open	Opens the find and replace panel

Settings

Setting	Description	Default
scopeReplace.caseSensitive	Match uppercase and lowercase exactly	false

Tips

• Always preview matches before replacing.
• Use version control (like Git) so you can easily undo changes if needed.
• Start with a small set of files to test your search first.

Development

Want to run the extension on your own computer?

1. Clone the repository

git clone https://github.com/your-username/Scope-Replace.git
cd Scope-Replace

2. Install dependencies

npm install

3. Run the extension

1. Open the project in VS Code.
2. Press F5. A new VS Code window will open with the extension loaded.

4. Build a package

npm install -g @vscode/vsce
vsce package

This creates a .vsix file you can install or share.

Project Structure

├── src/
│   └── extension.ts   # Main extension code
├── package.json       # Extension info, commands, and settings
└── README.md

Contributing

Ideas, bug reports, and pull requests are welcome.

1. Fork this repository
2. Create a new branch (git checkout -b my-feature)
3. Make your changes and commit them
4. Push to your branch
5. Open a Pull Request

Known Issues

• None yet. Please open an issue if you find one.

Roadmap

• Regex support
• Save and reuse search patterns
• Folder-level selection
• Undo all replacements

License

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

Author

Made by Mudassar Sindoli(https://github.com/mudassarsindoli)

If this extension saves you time, please give it a ⭐ on GitHub.