From 28ce90234f9f3fe7cf0e6c06433561dd6c7b1639 Mon Sep 17 00:00:00 2001
From: Shreyas <CuriousCorrelation@gmail.com>
Date: Mon, 28 Jul 2025 20:53:53 +0530
Subject: [PATCH] docs(agent): add README (#5286)

This adds documentation for the Hoppscotch Agent package covering
 installation, configuration, and usage.

 Closes FE-942
 Closes #5284

 The agent package lacked user-facing documentation beyond the minimal
 Tauri template content. Users needed guidance for installation,
 registration, certificate management, proxy configuration, and
 troubleshooting.
---
 packages/hoppscotch-agent/README.md       | 283 +++++++++++++++++++++-
 packages/hoppscotch-agent/public/icon.png | Bin 0 -> 13051 bytes
 2 files changed, 274 insertions(+), 9 deletions(-)
 create mode 100644 packages/hoppscotch-agent/public/icon.png

diff --git a/packages/hoppscotch-agent/README.md b/packages/hoppscotch-agent/README.md
index 5047afc6..8d850ae4 100644
--- a/packages/hoppscotch-agent/README.md
+++ b/packages/hoppscotch-agent/README.md
@@ -1,16 +1,281 @@
-# Tauri + Vue + TypeScript
+<div align="center">
+   <img align="center" width="128px" src="public/icon.png" />
+   <h1 align="center"><b>Hoppscotch Agent</b></h1>
+   <h2 align="center">
+      <a href="https://github.com/hoppscotch/agent-releases">Download</a> |
+      <a href="https://docs.hoppscotch.io/documentation/clients/agent">Official Docs</a>
+   </h2>
+</div>
 
-This template should help get you started developing with Vue 3 and TypeScript in Vite. The template uses Vue 3 `<script setup>` SFCs, check out the [script setup docs](https://v3.vuejs.org/api/sfc-script-setup.html#sfc-script-setup) to learn more.
+<br/>
 
-## Recommended IDE Setup
+#### Hoppscotch Agent is a cross-platform HTTP request relay for Hoppscotch built with [Tauri V2](https://v2.tauri.app/) that adds capabilities like custom headers, certificates, proxies, and local access typically restricted in browsers.
 
-- [VS Code](https://code.visualstudio.com/) + [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar) + [Tauri](https://marketplace.visualstudio.com/items?itemName=tauri-apps.tauri-vscode) + [rust-analyzer](https://marketplace.visualstudio.com/items?itemName=rust-lang.rust-analyzer)
+The agent runs as a local system service on port `9119`, acting as an intermediary between the Hoppscotch web application and target APIs. It establishes an encrypted communication channel authenticated via an OTP registration process.
 
-## Type Support For `.vue` Imports in TS
+## Installation
 
-Since TypeScript cannot handle type information for `.vue` imports, they are shimmed to be a generic Vue component type by default. In most cases this is fine if you don't really care about component prop types outside of templates. However, if you wish to get actual prop types in `.vue` imports (for example to get props validation when using manual `h(...)` calls), you can enable Volar's Take Over mode by following these steps:
+### Standard Installation
 
-1. Run `Extensions: Show Built-in Extensions` from VS Code's command palette, look for `TypeScript and JavaScript Language Features`, then right click and select `Disable (Workspace)`. By default, Take Over mode will enable itself if the default TypeScript extension is disabled.
-2. Reload the VS Code window by running `Developer: Reload Window` from the command palette.
+1. Download the latest version of Hoppscotch Agent from [releases](https://github.com/hoppscotch/agent-releases)
+2. Run the installer
+3. Follow the installation wizard to complete setup
+4. The agent automatically starts and appears in your system tray
 
-You can learn more about Take Over mode [here](https://github.com/johnsoncodehk/volar/discussions/471).
+### Portable Version
+
+The portable version runs without installation and does not include automatic updates.
+
+1. Download the portable version for your operating system
+2. Extract the archive to your desired location
+3. Run the executable directly
+4. The agent will start and appear in your system tray
+
+> [!Note]
+> The portable version uses a separate configuration (`tauri.portable.conf.json`) that disables bundling and updater functionality.
+
+## Getting Started
+
+### Registration
+
+1. Open Hoppscotch web app and navigate to **Settings** → **Interceptors**
+2. Select **Agent** from the available interceptors  
+3. Click **Register Agent** button
+4. The agent window displays a 6-digit verification code
+5. Enter the verification code in the OTP input field
+6. Click the confirm button to establish connection
+7. The agent displays a masked auth key hash when successfully registered
+
+### Usage
+
+Once registered, all HTTP requests made through Hoppscotch are processed by the agent. The agent provides:
+
+- CORS bypass by processing requests locally
+- Client certificate authentication for mutual TLS
+- HTTP Digest Authentication using challenge-response mechanisms  
+- Custom headers that browsers typically restrict
+- Proxy routing with authentication support
+- Local network and localhost access
+- SSL/TLS verification controls
+- And much more
+
+## Domain-Specific Configuration
+
+The agent (and `Native`) interceptor supports per-domain configuration overrides with a global default (`*`) domain:
+
+### Domain Management
+- **Global Defaults**: Base settings applied to all domains (domain: `*`)
+- **Domain Overrides**: Specific settings for individual domains (e.g., `api.example.com`)
+- **Domain Addition**: Add new domains through the domain management modal
+- **Domain Removal**: Remove custom domain configurations (global default cannot be removed)
+
+### SSL/TLS Security Settings
+
+For each domain, configure:
+
+- **Verify Host**: Enable/disable hostname verification during SSL handshake
+- **Verify Peer**: Enable/disable peer certificate verification
+- **CA Certificates**: Upload custom Certificate Authority certificates for domain validation
+- **Client Certificates**: Configure client certificates for mutual TLS authentication
+
+## Client Certificates
+
+The agent supports client certificate authentication for APIs requiring mutual TLS:
+
+### Certificate Formats
+- **.pem certificates**: Requires separate certificate (.crt/.cer/.pem) and private key (.key/.pem) files
+- **.pfx/.pkcs12 certificates**: Single file format with optional password protection
+
+### Configuration
+
+1. Access **Settings** → **Interceptors** → **Agent** in Hoppscotch
+2. Select the target domain from the domain selector
+3. Click **Client Certificates** button
+4. Choose certificate format (PEM or PFX tab)
+5. Upload certificate files:
+   - **PEM**: Upload certificate file and private key file separately  
+   - **PFX**: Upload .pfx/.pkcs12 file and enter password if required
+6. Configuration is automatically saved per domain
+
+### CA Certificates
+
+Custom Certificate Authority certificates can be added per domain:
+
+1. Navigate to the CA Certificates section for the target domain
+2. Click **Add Certificate File** 
+3. Upload the CA certificate file
+4. Toggle certificate inclusion on/off as needed
+5. Remove certificates using the trash icon
+
+## Proxy Configuration
+
+The agent supports HTTP/HTTPS proxy routing with authentication (including NTLM):
+
+### Proxy Settings
+- **Proxy URL**: HTTP/HTTPS proxy server address with port
+- **Proxy Authentication**: Username and password for proxy server authentication
+- **Per-Domain**: Each domain can have different proxy configurations
+
+### Configuration
+
+1. Select the target domain
+2. Toggle the **Proxy** switch to enable
+3. Enter the proxy URL (e.g., `http://proxy.example.com:8080`)
+4. Configure proxy authentication if required:
+   - Username field
+   - Password field (with show/hide toggle)
+
+## System Integration
+
+### System Tray
+The agent runs with system tray integration, providing access to:
+- **Show Registrations**: View active connections and registration status
+- **Clear Registrations**: Remove all registered instances  
+- **Maximize Window**: Show the agent interface window
+- **Quit**: Exit the agent application
+
+### Configuration Storage
+The agent stores configuration in platform-specific locations:
+
+- **Windows**: `%APPDATA%\io.hoppscotch.agent\`
+- **macOS**: `~/Library/Application Support/io.hoppscotch.agent/`  
+- **Linux**: `~/.config/io.hoppscotch.agent/`
+
+### Logging
+Logs are stored in platform-specific directories:
+
+- **Windows**: `%LOCALAPPDATA%\io.hoppscotch.agent\logs\`
+- **macOS**: `~/Library/Logs/io.hoppscotch.agent/`
+- **Linux**: `~/.local/share/io.hoppscotch.agent/logs/`
+
+### Auto-Start Configuration
+The standard installation includes auto-start functionality. The portable version does not include auto-start and must be launched manually.
+
+## Building from Source
+
+### Prerequisites
+
+- [Node.js](https://nodejs.org/) (v18 or later)
+- [pnpm](https://pnpm.io/) package manager
+- [Rust](https://rustup.rs/) (latest stable)
+- [Tauri CLI](https://tauri.app/v1/guides/getting-started/prerequisites)
+
+### Development
+
+```bash
+# Clone the repository  
+git clone https://github.com/hoppscotch/hoppscotch.git
+cd hoppscotch/packages/hoppscotch-agent
+
+# Install dependencies
+pnpm install
+
+# Start development server
+pnpm tauri dev
+```
+
+### Production Build
+
+```bash
+# Build standard version
+pnpm tauri build
+
+# Build portable version  
+pnpm tauri build --config src-tauri/tauri.portable.conf.json
+```
+
+The built applications will be available in `src-tauri/target/release/bundle/`
+
+### Build Variants
+
+Two build configurations are available:
+
+- **Standard** (`tauri.conf.json`): Includes installer, auto-updater, and auto-start functionality
+- **Portable** (`tauri.portable.conf.json`): Standalone executable without installation requirements
+
+## Network Configuration
+
+### Default Port
+The agent runs on port `9119` by default. Make sure this port is not blocked by firewalls.
+
+### Communication Protocol
+- **Encryption**: AES-256-GCM for all agent-to-web-app communication
+- **Authentication**: X25519 key exchange for secure channel establishment
+- **Registration**: One-time 6-digit OTP verification process
+
+## System Requirements
+
+### Windows
+- **OS Version**: Windows 10 1803+ or Windows 11
+- **Architecture**: x64
+- **Dependencies**: WebView2 Runtime (auto-installed for standard version)
+
+### macOS  
+- **OS Version**: macOS 10.15 (Catalina) or later
+- **Architecture**: Intel x64 or Apple Silicon (ARM64)
+
+### Linux
+- **Architecture**: x64
+- **Dependencies**: WebKit2GTK 2.44.0+ (usually pre-installed)
+- **Minimum**: Systems with GLIBC 2.38+
+
+## Troubleshooting
+
+### Agent Detection Issues
+1. **"Agent not detected" popup**: Verify the agent is running by checking the system tray for the Hoppscotch icon
+2. **Switching interceptors blocked**: If the "Agent not detected" popup prevents switching interceptors, restart your browser and stop the agent before changing interceptor settings
+3. **Port accessibility**: Check that no firewall is blocking port `9119`  
+4. **Browser compatibility**: Safari on macOS may have CORS issues with localhost:9119 due to access control checks, try Chrome/Firefox for agent registration
+
+### Registration Failures  
+1. **"Failed to initiate the registration"**: This error may occur due to browser security policies or extension conflicts
+2. **Missing OTP input field**: Verify the agent window is focused and displaying a 6-digit verification code
+3. **OTP expiration**: Registration codes have limited lifetime, restart the registration process if the code expires
+4. **Network connectivity**: Verify browser can reach localhost:9119/handshake
+5. **Version compatibility**: Some agent versions may be incompatible with specific Hoppscotch web app versions. For self-hosted setups, make sure Agent version in the release matches, see https://github.com/hoppscotch/hoppscotch/issues/4936#issuecomment-2756981053
+
+### Certificate Issues
+1. Verify certificate format is supported (.pem or .pfx/.pkcs12)
+2. Check certificate expiration dates
+3. Confirm private key matches certificate (for .pem files)
+4. Verify domain configuration matches target API hostname
+5. Confirm certificate password is correct (for .pfx/.pkcs12)
+6. Check CA certificate inclusion status (toggle on/off)
+
+### Request Processing Issues
+1. **Custom headers not applied**: Verify the agent is selected as interceptor, browsers may override headers like User-Agent when using default HTTP methods
+2. **CORS errors**: Confirm agent interceptor is active and requests are routing through localhost:9119
+3. **SSL/TLS verification**: Check verify host/peer settings for the target domain
+4. **Proxy routing**: Verify proxy URL format includes protocol (http:// or https://)
+
+### System-Specific Issues
+
+#### Windows
+1. Check WebView2 Runtime is installed (auto-installed with standard version)
+2. Check Windows Defender or antivirus exclusions for the agent executable
+3. Verify agent has network permissions through Windows Firewall
+
+#### macOS  
+1. Safari browser may block agent connections due to CORS policies, try Chrome or Firefox instead
+2. Check macOS Gatekeeper settings if agent fails to start
+3. Verify agent is allowed in System Preferences →  Security & Privacy
+
+#### Linux
+1. Check WebKit2GTK dependencies are installed
+2. Check systemd logs if agent fails to start as service
+3. Verify GLIBC version compatibility (requires 2.38+)
+
+### Portable Version Issues
+1. Manual WebView2 installation - may be required on older versions of Windows
+2. No auto-start capability - must launch manually after system restart  
+3. No automatic updates - download new versions manually
+4. Verify executable permissions on Unix-like systems
+5. Check that portable version is extracted to a writable directory
+
+### Log
+Check agent logs for detailed error information:
+- **Windows**: `%LOCALAPPDATA%\io.hoppscotch.agent\logs\`
+- **macOS**: `~/Library/Logs/io.hoppscotch.agent/`
+- **Linux**: `~/.local/share/io.hoppscotch.agent/logs/`
+
+Look for connection errors, certificate validation failures, or proxy authentication issues in the log files.
diff --git a/packages/hoppscotch-agent/public/icon.png b/packages/hoppscotch-agent/public/icon.png
new file mode 100644
index 0000000000000000000000000000000000000000..3778416df43ca62bdb6a9975a662be32e1901724
GIT binary patch
literal 13051
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
JPDHLkV1iXVVATKs

literal 0
HcmV?d00001