Gurl CLI

Environments

Mon, 01 Jan 0001 00:00:00 +0000

Manage variables and secrets across deployment stages

GraphQL

Mon, 01 Jan 0001 00:00:00 +0000

Execute GraphQL queries from the terminal

Installation

Mon, 01 Jan 0001 00:00:00 +0000

Prerequisites

Gurl requires no runtime dependencies — it ships as a single static binary. Go is only needed if you are building from source (Go 1.21+).

Homebrew (macOS / Linux)

brew tap bsreeram08/gurl https://github.com/bsreeram08/gurl
brew install gurl

Update with:

brew upgrade gurl

One-liner Install

curl -sL https://raw.githubusercontent.com/bsreeram08/gurl/master/scripts/install.sh | bash

This detects your platform, downloads the correct binary from the latest release, and installs it to /usr/local/bin.

Pre-built Binaries

Download directly from GitHub Releases:

Credential Storage

Mon, 01 Jan 0001 00:00:00 +0000

How Gurl stores and encrypts your API credentials

gRPC & WebSocket

Mon, 01 Jan 0001 00:00:00 +0000

Work with gRPC and WebSocket APIs

Memory Safety for AI Agents

Mon, 01 Jan 0001 00:00:00 +0000

How Gurl prevents credential leakage in AI context windows

Plugin System

Mon, 01 Jan 0001 00:00:00 +0000

Extensible middleware, output, and command plugins

Quick Start

Mon, 01 Jan 0001 00:00:00 +0000

Get started with Gurl in 5 minutes. This guide walks through the core workflow: saving a request, running it, and generating code.

Step 1: Save a Request

Save your first request with the save command:

gurl save "users" https://jsonplaceholder.typicode.com/users

This saves a GET request to the users endpoint. Gurl creates the collection automatically if it does not exist.

You can also save requests with common options inline:

gurl save "user-by-id" https://jsonplaceholder.typicode.com/users/1

Step 2: Run the Request

Execute the saved request with the run command:

Scripting

Mon, 01 Jan 0001 00:00:00 +0000

JavaScript pre/post-request scripts for complex API workflows

Assertions

Mon, 01 Jan 0001 00:00:00 +0000

Validate API responses with declarative assertions

Header Redaction

Mon, 01 Jan 0001 00:00:00 +0000

How Gurl prevents credential leakage in logs

Collection Runner

Mon, 01 Jan 0001 00:00:00 +0000

Run entire API test suites with data-driven testing

gurl codegen

Mon, 01 Jan 0001 00:00:00 +0000

Generate code from a saved request

gurl collection

Mon, 01 Jan 0001 00:00:00 +0000

Manage request collections

gurl delete

Mon, 01 Jan 0001 00:00:00 +0000

Remove a saved request

gurl detect

Mon, 01 Jan 0001 00:00:00 +0000

Parse curl from stdin or file

gurl diff

Mon, 01 Jan 0001 00:00:00 +0000

Compare responses for a request

gurl edit

Mon, 01 Jan 0001 00:00:00 +0000

Edit a saved request

gurl env

Mon, 01 Jan 0001 00:00:00 +0000

Manage environment variables

gurl export

Mon, 01 Jan 0001 00:00:00 +0000

Export requests to file

gurl graphql

Mon, 01 Jan 0001 00:00:00 +0000

Execute a GraphQL query

gurl history

Mon, 01 Jan 0001 00:00:00 +0000

Show execution history for a request

gurl import

Mon, 01 Jan 0001 00:00:00 +0000

Import from external formats

gurl list

Mon, 01 Jan 0001 00:00:00 +0000

List saved requests

gurl paste

Mon, 01 Jan 0001 00:00:00 +0000

Copy request as curl to clipboard

gurl rename

Mon, 01 Jan 0001 00:00:00 +0000

Rename a saved request

gurl run

Mon, 01 Jan 0001 00:00:00 +0000

Execute a saved request

gurl save

Mon, 01 Jan 0001 00:00:00 +0000

Save a curl request with a name

gurl sequence

Mon, 01 Jan 0001 00:00:00 +0000

Manage request sequences

gurl show

Mon, 01 Jan 0001 00:00:00 +0000

Show details of a saved request

gurl timeline

Mon, 01 Jan 0001 00:00:00 +0000

Show global execution timeline

gurl tui

Mon, 01 Jan 0001 00:00:00 +0000

Launch interactive TUI

gurl update

Mon, 01 Jan 0001 00:00:00 +0000

Update gurl to latest version