🚀 Endpoint

The REST Client that feels like home in VS Code

Test APIs without leaving your editor. Beautiful native GUI. Zero context switching.

✨ Why Endpoint?

🎯 Features

🛠️ Full-Featured Request Builder

Build any HTTP request with an intuitive tabbed interface:

• Methods: GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS
• Query Params: Visual key-value editor
• Headers: Add, remove, enable/disable with toggles
• Auth: None, Basic, Bearer Token, API Key (header or query param)
• Body: JSON, Form Data, Raw Text, XML
• Resizable Split Pane: Drag the divider between request and response to customize your view
• Response Compression: Automatic gzip/deflate decompression
• Syntax Highlighting: Beautiful code highlighting for JSON, XML, HTML responses

⚡ Pre-Request Execution (chaining)

Run another request automatically before your main request — perfect for auth token refresh:

1. Open a request's Settings tab
2. Select a "Pre-Request" from the dropdown
3. The pre-request runs first, storing its response for chaining

Cycle detection prevents infinite loops (A→B→A chains are blocked).

🔗 Request Chaining

Chain requests together — grab a token from one response and use it in the next.

How to use:

1. Name your first request — Enter a name in the "Name" field (e.g., login)
2. Send the request — The response is automatically stored in memory
3. Reference in the next request — Use {{requestName.response.body.path}} in URL, headers, or body

### Login
# Name: "login"
POST {{baseUrl}}/auth/login
Content-Type: application/json

{"username": "admin", "password": "secret"}

### Use the token
GET {{baseUrl}}/protected/resource
Authorization: Bearer {{login.response.body.token}}

Note: Responses are session-scoped and cleared when VS Code restarts.

📋 Copy as Code

Generate code snippets in 6 languages — right-click any request or use the Command Palette:

Variable handling: Choose to resolve variables with current values or keep {{placeholders}} — placeholders convert to language-specific environment variable syntax (e.g., process.env.VAR for JavaScript).

🌍 Smart Variables

Variables resolve automatically with intelligent precedence:

1. 🔹 Request-level (@baseUrl = ...)
2. 🔹 Active environment
3. 🔹 Collection-level variables
4. 🔹 .env file (workspace root)
5. 🔹 Built-in dynamic values

.env file support: Place a .env file in your workspace root and variables are automatically available:

# .env
BASE_URL=https://api.example.com
API_KEY=your-secret-key

Built-in variables:

📦 Collection Defaults

Set default headers, auth, and variables for an entire collection — individual requests can override:

1. Right-click collection → Collection Settings
2. Add default headers, auth, or collection-level variables
3. All requests inherit these automatically

Inheritance controls:

• Requests can disable individual inherited headers
• Auth can be set to "Inherit from Collection" or overridden per-request

📂 Repo-Based Collections

Share collections with your team via version control:

1. Right-click a collection → Store in Repository
2. Collection is saved to .endpoint/collections/ as JSON
3. Commit and push — team members get the collection automatically

What gets shared:

• ✅ Requests (URL, method, headers, body)
• ✅ Collection structure and metadata
• ✅ Non-sensitive configuration

What stays local:

• 🔒 Passwords, tokens, API keys (stored in VS Code's secure storage)
• Team members configure their own credentials

.gitignore recommendations:

By default, .endpoint/collections/*.json files are safe to commit. If you need to exclude specific collections:

# Exclude specific collections
.endpoint/collections/my-local-only.json

# Or exclude all (not recommended)
.endpoint/collections/

📜 History Management

Every request you send is automatically tracked:

• Replay: Click any history item to reopen and resend
• Save to Collection: Right-click → Save to preserve a useful request
• Delete: Remove individual items or clear all history
• Configurable Limit: Control how many items to retain in settings

⚡ Quick Run Request

Instantly search and execute any request across all collections:

• Keyboard Shortcut: Ctrl+Shift+X (Mac: Cmd+Shift+X)
• Command Palette: "Endpoint: Quick Run Request"

Features:

• Fuzzy search across request names, methods, URLs, and collection names
• HTTP method icons for quick visual scanning
• Sends the request immediately upon selection

🔍 Variable Diagnostics

Catch undefined variables before you send — no more debugging "variable not found" errors:

• Problems Panel Integration: View → Problems (Ctrl+Shift+M) shows undefined variable warnings
• Scans All Sources: Checks against active environment, .env file, and collection variables
• Request Coverage: Checks URLs, headers, body, and auth configuration

Diagnostics update automatically when you:

• Switch environments
• Add/edit/delete variables
• Modify collections or requests

🌐 Status Bar Environment Switcher

See your active environment at a glance and switch instantly:

• Status Bar: Shows current environment name with globe icon (bottom left)
• One-Click Switch: Click to open environment quick picker
• Clear Option: Easily deactivate all environments

👋 Welcome Views

Friendly onboarding when you're getting started:

• Empty Collections: Shows "Create Collection" and "Import" links
• Empty Environments: Explains what environments are and how to create one

📥 Smart Import

Import .http and .rest files with intelligent processing:

• Auth Detection: Authorization: Bearer and Authorization: Basic headers are automatically converted to proper auth configuration
• Variable Extraction: File-level variables are detected and can create a new environment
• Import Summary: Detailed report showing what was imported and recommended next steps
• REST Client Compatibility: {{$dotenv VAR}} syntax is automatically converted to {{VAR}}

🔄 Settings Sync

Your collections and environment metadata sync across machines via VS Code's built-in Settings Sync:

• ✅ Collections (all requests, headers, structure)
• ✅ Environment names and variable names
• ❌ Environment variable values stay local (stored in OS secure storage)
• ❌ History (machine-specific)

⚡ Quick Start

Status bar: Click the environment name in the bottom left to quickly switch environments.

Context menus: Right-click on collections, requests, environments, and history items for all available actions including Copy as Code, Save to Collection, Duplicate, and more.

Or use the Collections sidebar — click ➕ to create, right-click to export.

📄 File Format

Standard .http format — works with other tools too:

@baseUrl = https://api.example.com
@token = my-secret-token

### Get all users
GET {{baseUrl}}/users
Authorization: Bearer {{token}}
Accept: application/json

### Create user
POST {{baseUrl}}/users
Content-Type: application/json

{
    "name": "John Doe",
    "email": "john@example.com"
}

⚙️ Configuration

npm install
npm run watch

src/
├── codegen/          # Code generation (6 languages)
├── commands/         # Import/Export/Copy as Code
├── http/             # HTTP client & syntax highlighting
├── models/           # Data interfaces
├── parser/           # .http parser & variable resolver
├── providers/        # Sidebar views & decorations
├── storage/          # Persistence & .env support
└── webview/          # Request panel UI

📝 License

MIT