CLI reference

One page per command, in alphabetical order. Every page has the same layout: synopsis, flags, aliases, examples and related commands. Flag tables are checked against gurl docs --json from the binary; run gurl docs for the reference that matches your installed version.

Commands

Command	What it does
`auth`	List auth handlers and their parameters
`codegen`	Generate Go, Python, JavaScript or curl code from a request
`collection`	Manage collections, their variables, and collection runs
`cookies`	List, delete and clear stored cookies
`delete`	Remove a saved request
`detect`	Parse a curl command from stdin or a file
`diag`	Inspect one recorded execution
`diff`	Compare the latest responses of a request
`docs`	Print a compact reference of every command and concept
`edit`	Change fields of a saved request
`env`	Manage environments and their variables
`exec`	Run a command with an environment’s variables injected
`export`	Export requests to a file
`extract`	Test extraction rules against a sample response
`graphql`	Execute a GraphQL query
`grpc`	Execute a gRPC request
`history`	Show execution history for a request
`import`	Import from OpenAPI, Insomnia, Bruno, Postman, HAR or gurl exports
`init`	Initialize a project (`.gurl/`)
`list`	List saved requests
`paste`	Copy a request as curl to the clipboard
`receive`	Decrypt a share bundle and import it
`rename`	Rename a saved request
`run`	Execute a saved request
`save`	Save a request under a name
`sequence`	Set execution order within a collection
`share`	Encrypt requests to a recipient’s public key
`shell`	Launch the typed interactive shell
`show`	Show a saved request
`sse`	Connect to a Server-Sent Events endpoint
`timeline`	Show executions across all requests
`update`	Update gurl to the latest release
`ws`	Open a WebSocket connection

gurl tui is a hidden, non-functional stub; use gurl shell for interactive use.

Global flags

These work with every command, in any position.

Flag	Short	Description
`--agent`		JSON output, no prompts, strict masking (or `GURL_AGENT=1`, or run the binary as `agentgurl`). See Agent mode.
`--no-input`		Never prompt; fail and name what to pass instead (or `GURL_NO_INPUT=1`)
`--project-dir`		Project root containing `.gurl` file storage (or `GURL_PROJECT_DIR`)
`--version`	`-v`	Print the version

Exit codes

0 success, 1 error, 2 usage error; gurl exec exits with its command’s code. Details and the JSON error shape are in JSON output.