gurl is a CLI API workbench. Save, organize, and execute HTTP requests from the terminal — with built-in auth handling, scripting, collection runner, and code generation.

Status: early (v0.4.x). The CLI works. The TUI exists in code but is not functional yet.

CLI API workbench.

Save any request, run it by name, manage auth and environments, and generate client code — all from the terminal. Works well for humans and AI agents alike.

Features

21 CLI Commands

Every command you need for API workflows: save, run, list, edit, delete, duplicate, export, import, and more.

8 Auth Handlers

Programmatic credential injection for every auth scheme:

5 Protocol Clients

Support for modern API protocols:

• HTTP - Full request/response with multipart support
• GraphQL - Query, mutation, subscription
• gRPC - Proto-based RPC with reflection
• WebSocket - Real-time bidirectional
• SSE - Server-sent events

Scripting Engine

Extend requests with JavaScript using the goja runtime. Modify headers, transform responses, or chain dependent requests with full access to the request and response objects.

Collection Runner

Run collections with data-driven testing. Feed CSV or JSON test data, assert on response status, body, and headers.

Plugin System

Extend gurl with middleware for request/response transformation, custom output formatters, and additional CLI commands. Plugins hook into the request lifecycle.

Interactive TUI (not functional yet)

A TUI built with bubbletea exists in the codebase but is not functional. The gurl tui command is present but the interface is not usable. This is planned for a future release.

Multi-language Code Generation

Generate idiomatic client code from saved requests:

gurl codegen "my-request" --lang python
gurl codegen "my-request" --lang javascript
gurl codegen "my-request" --lang go
gurl codegen "my-request" --lang curl

Quick Start

brew tap bsreeram08/gurl https://github.com/bsreeram08/gurl
brew install gurl
gurl save "my-api" https://api.example.com/users -H "Authorization: Bearer $TOKEN"
gurl run "my-api"

Save any request, run it instantly, generate code, and share with your team.

Built for AI Agents

They never touch your credentials.

Gurl is designed for AI agent workflows where security matters. Credentials never appear in logs, never leak into prompts, and never get exposed to model providers.

Security model:

• Environment secrets encrypted at rest with AES-256-GCM
• Auth handlers inject credentials programmatically
• Header redaction in all log output
• No credentials in generated code without explicit flags

See the AI integration page for how Gurl works with AI agents.

Why Gurl

• Local-first — no account, no cloud sync, no lock-in
• Git-friendly — collections are just data, export and version them
• Scriptable — JavaScript pre/post-request hooks, chain requests, CI-ready exit codes
• Open source — inspect and extend everything