fetch

fetch

A modern HTTP(S) client for the command line.

Features

• Response formatting - Automatic formatting and syntax highlighting for JSON, XML, YAML, HTML, CSS, CSV, Markdown, MessagePack, Protocol Buffers, and more
• Image rendering - Display images directly in your terminal
• WebSocket support - Bidirectional WebSocket connections with automatic JSON formatting
• gRPC support - Make gRPC calls with automatic reflection, discovery, and JSON-to-protobuf conversion
• Authentication - Built-in support for Basic Auth, Bearer Token, AWS Signature V4, and mTLS
• Compression - Automatic gzip and zstd response body decompression
• TLS inspection - Inspect TLS certificate chains, expiry, SANs, and OCSP status
• DNS inspection - Inspect hostname resolution, record families, TTLs, and resolver timing
• Timing waterfall - Visualize request timing phases (DNS, TCP, TLS, TTFB, transfer) with a waterfall chart
• Configuration - Global and per-host configuration file support

Quick Start

Install

# Install fetch from the shell script (macOS or Linux)
curl -fsSL https://raw.githubusercontent.com/ryanfowler/fetch/main/install.sh | bash

# Or install fetch with homebrew (macOS or Linux)
brew install ryanfowler/tap/fetch

# Or install fetch with Go
go install github.com/ryanfowler/fetch@latest

Usage

# Make a request for JSON
fetch httpbin.org/json

# Make a request for an image
fetch picsum.photos/1024/1024

Documentation

• Getting Started - Installation, first steps, and basic concepts
• CLI Reference - Complete reference for all command-line options
• Configuration - Configuration file format and options
• Authentication - Basic, Bearer, AWS SigV4, and mTLS
• Request Bodies - JSON, XML, forms, multipart, and file uploads
• Output Formatting - Supported content types and formatting options
• Image Rendering - Terminal image protocols and formats
• WebSocket - Bidirectional WebSocket connections
• gRPC - Making gRPC requests with Protocol Buffers
• Advanced Features - DNS, proxies, TLS, HTTP versions, and more
• Troubleshooting - Common issues, debugging, and exit codes

License

fetch is released under the MIT License.