⚡ kurl

Go Report Card Build & Release Status License: MIT Homebrew Formula Go 1.22+

kurl Banner

Zero-config scheme probing, concurrent triple-DNS racing, token-by-token syntax highlighting, built-in JSONPath filtering, native GraphQL, Server-Sent Events (SSE), request replays, and environment profiles. All packed into a single static binary with zero dependencies.

Quick Start • Installation • Feature Showcase • Architecture • Documentation

🚀 Why kurl?

📊 Feature Comparison Matrix

📦 Installation

macOS / Linux (Homebrew)

brew tap kavix/tap
brew install kurl

Direct Download (Pre-compiled Binaries)

# macOS (Apple Silicon / M1 / M2 / M3)
curl -sSL https://github.com/kavix/kurl/releases/latest/download/kurl_darwin_arm64.tar.gz | tar -xz && sudo mv kurl /usr/local/bin/
# Linux (x86_64)
curl -sSL https://github.com/kavix/kurl/releases/latest/download/kurl_linux_amd64.tar.gz | tar -xz && sudo mv kurl /usr/local/bin/

From Source (Go 1.22+)

git clone https://github.com/kavix/kurl.git
cd kurl
make install

⚡ Quick Start

# 1. Zero-config scheme probing & DNS racing (auto-resolves https://)
kurl api.github.com/users/kavix
# 2. Native JSONPath filtering without piping to jq!
kurl https://api.github.com/users/kavix --filter .company
# 3. CSV Key projection & object filtering
kurl https://api.github.com/users/kavix --filter-keys "login, name, location, public_repos"
# 4. Native GraphQL queries with variables
kurl graphql https://countries.trevorblades.com/ --query '{ country(code: "LK") { name capital currency emoji } }'
# 5. Live Server-Sent Events (SSE) streaming with event filtering
kurl sse https://api.example.com/events --sse-filter message
# 6. Save a request profile and replay it with overrides
kurl save github-user GET https://api.github.com/users/kavix -H "Accept: application/json"
kurl run github-user -v
# 7. Environment profiles (dev / staging / prod)
kurl --env prod /users/search
# 8. Invoke a gRPC service using server reflection
kurl grpc://api.example.com:443 mypackage.MyService/MyMethod

✨ Feature Showcase

1. 🔍 Built-in JSONPath Filtering (--filter, --filter-keys, --filter-flatten)

# Extract single or nested fields
kurl https://api.github.com/users/kavix --filter .name
# Project specific keys from objects or arrays
kurl https://api.github.com/users/kavix --filter-keys "name, bio, public_repos"
# Flatten multi-dimensional array payloads
kurl https://api.example.com/matrix --filter-flatten

2. 🔷 Native GraphQL Engine (kurl graphql)

# Execute GraphQL query
kurl graphql https://api.example.com/graphql --query '{ user(id: 1) { name email } }'
# Execute with JSON variables
kurl graphql https://api.example.com/graphql --query 'query GetUser($id: ID!) { user(id: $id) { name } }' --variables '{"id": "123"}'
# Execute schema introspection
kurl graphql https://api.example.com/graphql --introspect
# Auto-generate GraphQL query template for a type
kurl graphql https://api.example.com/graphql --generate-query User

3. 📡 Server-Sent Events (SSE) Streamer (kurl sse)

# Stream all SSE events
kurl sse https://api.example.com/stream
# Stream and filter specific event types
kurl sse https://api.example.com/stream --sse-filter update
# Stream and record events to a log file
kurl sse https://api.example.com/stream --sse-output sse_events.log

4. 🔗 Native gRPC Client (kurl grpc://)

# List available services via reflection
kurl grpc://api.example.com:443 --list-services
# Invoke a method with a JSON payload
kurl -d '{"id": "123"}' grpc://api.example.com:443 mypackage.MyService/MyMethod
# Use local .proto files instead of server reflection
kurl --proto ./service.proto grpc://api.example.com:443 mypackage.MyService/MyMethod
# Connect with mTLS certificates
kurl --cert client.crt --key client.key grpc://api.example.com:443 mypackage.MyService/MyMethod

5. ⚡ Triple-DNS Racing Resolver

🛠️ Configuration & Environment Profiles

{
 "dev": {
 "base_url": "http://localhost:8080/v1",
 "headers": [
 "X-Environment: development",
 "Authorization: Bearer dev-secret-token"
 ]
 },
 "prod": {
 "base_url": "https://api.production.com/v1",
 "headers": [
 "X-Environment: production",
 "Authorization: Bearer prod-secret-token"
 ]
 }
}

kurl --env dev /users/123
kurl --env prod /users/123

📐 Architecture & Performance

🤝 Contributing

📄 License