Repository navigation
v0.4.0
v0.4.0
This release makes collections first-class and git-friendly. Collections can now carry scoped variables, encrypted secrets, project-backed JSON storage, passphrase sharing, and AI-agent-friendly workflows.
Added
- First-class collections with scoped variables and encrypted collection secrets.
- Collection variable precedence: CLI variables override collection variables, which override environment variables.
gurl collection create,set-var,unset-var,show,delete,migrate,export,import, andunlockworkflows.- Git-friendly project storage under
.gurl/collections/and.gurl/environments/, with project discovery via parent-directory walk-up,GURL_PROJECT_DIR, or--project-dir. - File-backed collections as one
collection.jsonplus one JSON file per request for reviewable diffs. - File-backed environment storage with encrypted secrets.
- Per-collection encryption keys for DB-backed and file-backed collections.
- Passphrase-protected collection export/import and passphrase-protected project migration.
- OS keychain caching for passphrase-protected file-backed collections, with local-key fallback when keychain storage is unavailable.
- Collection directory import and native top-level collection export/import.
.envimport into collection variables withgurl collection import <name> --file <path>.- File watching for long-running file-backed collection runs and shell sessions.
- GitHub Container Registry packaging via
ghcr.io/bsreeram08/gurl. - README guidance for AI agents using gurl safely without exposing credentials.
Fixed
gurl save --collectionnow guards against typo-created collections and preserves real storage lookup failures.--persistroutes dirty variables back to their origin: environment variables to environments, collection variables to collections, and new variables to the active collection when present.- Cross-collection chains refresh collection variable context on each request step.
- File-backed deletion removes migrated DB shadow records instead of allowing deleted requests to reappear.
- Locked collection handling now fails with actionable errors instead of silently consuming ciphertext.
- Encrypted-value detection now validates ciphertext payloads before skipping encryption.
Install
Use the install script:
curl -sL https://raw.githubusercontent.com/bsreeram08/gurl/master/scripts/install.sh | bashOr run the container package:
docker run --rm ghcr.io/bsreeram08/gurl:v0.4.0 --versionOr download the platform binary/tarball from this release.
Full changelog: v0.3.1...v0.4.0