Intercept

Intercept HTTP/HTTPS traffic directly inside VS Code
A powerful proxy tool for developers and security researchers, inspired by Burp Suite.

• Installation
• Usage
• Screenshots
• Development
• Project Structure
• Contributing
• License

Installation

Prerequisites

• Node.js 18 or higher
• Visual Studio Code 1.75 or higher
• npm or yarn package manager

From VS Code Marketplace

1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X)
3. Search for "Intercept"
4. Click Install

Local Development Setup

# Clone the repository
git clone https://github.com/7acini/intercept.git
cd intercept

# Install dependencies
npm install

# Compile TypeScript
npm run compile

# Run in watch mode for development
npm run watch

Running the Extension

1. Open the project folder in VS Code
2. Press F5 to launch the Extension Development Host
3. The extension will be loaded in a new VS Code window

Packaging for Distribution

# Create a .vsix package
npm run package

# Install locally for testing
code --install-extension intercept-0.0.1.vsix

Usage

Starting the Proxy

1. Open the Intercept view in VS Code (View → Open View... → Intercept)
2. Click Start to launch the proxy server (default port: 8080)
3. Configure your browser or application to use the proxy

Browser Configuration

Set up a manual proxy in your browser:

• Host: 127.0.0.1
• Port: 8080

For HTTPS interception, you'll need to install the generated CA certificate.

HTTPS Interception (MITM)

1. Start the proxy (it auto-generates a CA certificate)
2. Locate the CA cert in the Intercept Global Storage folder (the extension shows a button to open it after start)
3. Install and trust the certificate in your system's certificate store
4. Restart your browser to apply the trust

Quick install commands:

• macOS: sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain "<path-to-ca-cert.pem>"
• Windows (PowerShell): certutil -addstore -f "Root" "<path-to-ca-cert.pem>"
• Linux (Debian/Ubuntu): sudo cp "<path-to-ca-cert.pem>" /usr/local/share/ca-certificates/intercept-ca.crt && sudo update-ca-certificates

⚠️ Security Note: Only use this for testing in controlled environments.

Intercept Workflow

• Toggle Intercept mode to pause requests before forwarding
• Edit requests in the Inspector panel
• Use the Repeater to modify and resend requests
• Export requests for external tools

Exporting Requests

From the request list, export as:

• cURL (ready-to-run shell command)
• Raw HTTP (plain text HTTP request)

Screenshots

Main Interface

Request Inspector

HTTPS Setup

Screenshots coming soon - contributions welcome!

Development

Building

npm run compile  # One-time build
npm run watch    # Watch mode for development

Recommended Workflow

1. Run npm run watch while editing
2. Press F5 to test in Extension Development Host
3. Use VS Code's debugger for troubleshooting

Testing

# Run tests (when implemented)
npm test

Code Quality

# Lint code
npm run lint

# Format code
npm run format

Contributing

We welcome contributions! Please see our Contributing Guide for details.

Quick Start for Contributors

1. Fork the repository
2. Create a feature branch: git checkout -b feature/your-feature
3. Make your changes and add tests
4. Submit a pull request

Development Setup

See the Installation section above.

Reporting Issues

• Open an Issue
• Start a Discussion

License

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

Made with ❤️ for developers and security researchers
GitHub • VS Code Marketplace