A GUI for managing and running Hurl HTTP request collections.

Run npx hurler in any project directory to get a web-based interface for organizing .hurl files, managing environments, and executing requests.

npx hurler

This starts a local server at http://localhost:4000 and stores data in a .hurl/ directory in your current working directory.

• Node.js 18+
• Hurl (for running requests)

npx hurler [options]

You can also set the port via the PORT environment variable.

npx hurler                  # start on port 4000
npx hurler -p 8080          # start on port 8080
npx hurler -o               # start and open browser
npx hurler -p 8080 -o       # combine flags

All data is stored in .hurl/ relative to where you run the command:

.hurl/
├── collections/    # .hurl request files
├── environments/   # environment variable files
└── metadata.json   # UI organization (sections, groups)

This directory is safe to commit to version control if you want to share collections with your team.

Hurler supports two types of environment files:

Both files are automatically merged when running requests. Variables from either file can be used in your .hurl files with {{variable}} syntax.

Add this to your .gitignore to keep secrets out of version control:

# Hurler secrets
.hurl/environments/*.secrets.env

# .hurl/environments/dev.env (safe to commit)
base_url=https://api.dev.example.com
timeout=30

# .hurl/environments/dev.secrets.env (gitignored)
api_key=sk-abc123...
auth_token=bearer-xyz...

Then use in your .hurl files:

GET {{base_url}}/users
Authorization: Bearer {{auth_token}}

MIT