Documentation
Gurl is a native macOS editor for Hurl files. This section covers the things you'll want to know after the first run: how settings work, how environments and variables are wired up, how the run history persists, every keyboard shortcut, and a note on the CLI.
Pick whichever topic you need from the sidebar — they're all self-contained.
Workspace layout
When you open a folder in Gurl, it creates a .gurl/ directory next to your .hurl files. The contents:
| Path | Purpose |
|---|---|
.gurl/settings.toml | Workspace settings — environments, title template, binary overrides |
.gurl/settings.local.toml | Per-machine overrides (gitignored automatically) |
.gurl/.gitignore | Keeps the state directory + local overrides out of git |
.gurl/state/ | App-private state: open tabs, run history, drag order, etc. |
You don't need to touch your repo's root .gitignore. Git auto-discovers nested .gitignore files and merges their rules with the surrounding ones — the .gurl/.gitignore Gurl writes is additive on top of whatever you've already got at the workspace root. Your existing rules keep applying; Gurl just adds the bits it needs (state/, settings.local.toml) inside its own directory.
There's also a global layer at ~/Library/Application Support/Gurl/settings.toml if you have preferences that should apply to every workspace (most commonly: hurl_path / hurlfmt_path). See Settings for the full layering rules.