HTTP Request Management
Made Simple
A powerful CLI tool for managing HTTP requests using YAML configuration files. Perfect for API testing, automation, and development workflows.
Simple YAML Configuration
Define your HTTP requests using clean, readable YAML files. Support for variables, templates, parallel execution, and response validation.
# api-tests.yaml
global:
variables:
BASE_URL: https://api.example.com
API_TOKEN: your-token-here
execution: parallel
requests:
- name: Get Users
url: ${BASE_URL}/users
method: GET
headers:
Authorization: Bearer ${API_TOKEN}
- name: Health Check
url: ${BASE_URL}/health
method: GET
validation:
status: 200
body:
status: okInstall
# Quick install (Linux/macOS)
curl -fsSL https://www.curl-runner.com/install.sh | bash
# Quick install (Windows PowerShell)
irm https://www.curl-runner.com/install.ps1 | iex
# Or with package managers
bun install -g @curl-runner/cli
npm install -g @curl-runner/cliRun
# Run your tests
curl-runner api-tests.yaml -v
# Run all YAML files in directory
curl-runner tests/ --parallel
# Save results to JSON
curl-runner api-tests.yaml --output results.jsonQuick to Install & Use
Get started in seconds with your preferred package manager. Works on Linux, macOS, and Windows with full cross-platform support.
Or Download Pre-compiled Binaries
Standalone executables for direct download. No dependencies required.
Everything you need for
HTTP request management
A comprehensive toolkit designed for developers who need reliable API testing and automation
Simple Configuration
Define HTTP requests using clean, readable YAML files with support for variables, templates, and validation.
Built with Bun
Exceptional performance for sequential and parallel request execution.
Beautiful Output
Progress indicators, colored output, and comprehensive error handling.
Flexible & Extensible
Global settings, variable interpolation, retries, and custom output formats.
Discover what makes
curl-runner powerful
Explore our comprehensive feature set designed for modern API testing and automation
Parallel Execution
Execute multiple HTTP requests simultaneously
Response Validation
Validate status, headers, and body content
Watch Mode
Auto-rerun on file changes
Retry Mechanism
Automatic retry with backoff
CI/CD Integration
Seamless pipeline integration
File Uploads
Multipart form data support
Output Formats
Multiple export formats
Response Storage
Save responses to disk
Conditional Execution
Run requests based on conditions
Performance Profiling
Detailed timing metrics
Response Diffing
Compare responses across environments
Dry Run Mode
Preview commands without executing
Snapshots
Snapshot testing for APIs
HTTP/2 Support
Enable HTTP/2 protocol with multiplexing
Connection Pooling
Reuse TCP connections with HTTP/2 multiplexing
YAML Wizard
Interactive CLI for creating YAML files
YAML Validation
Validate YAML files and auto-fix issues
Environment Files
Load .env files with secret redaction
Contributors
Meet the passionate developers who make curl-runner possible. Want to join us? We'd love to have you contribute to the project!
Ready to get started?
Join developers who trust curl-runner for their HTTP request management needs.