Pkl 0.33 Release Notes

Pkl 0.33 was released on XXX.
The latest bugfix release is 0.33.0. (All Versions)

The next release (0.34) is scheduled for February 2027. To see what’s coming in the future, follow the Pkl Roadmap.

Please send feedback and questions to GitHub Discussions, or submit an issue on GitHub.

Pkl is hosted on GitHub. To get started, follow Installation.

Highlights 💖

For new setups, the CLI no longer stores anything under ~/.pkl (#1809).

It uses XDG-style locations on Unix and Known Folder locations on Windows:

Concern Unix (Linux/macOS) Windows Legacy fallback

Concern	Unix (Linux/macOS)	Windows	Legacy fallback
Package cache	`~/.cache/pkl`	`$LOCALAPPDATA/pkl/Cache`	none
Settings file	`~/.config/pkl/settings.pkl`	`$APPDATA/pkl/settings.pkl`	`~/.pkl/settings.pkl`
CA certificates	`~/.config/pkl/cacerts`	`$APPDATA/pkl/cacerts`	`~/.pkl/cacerts`
REPL history	`~/.local/state/pkl/repl-history`	`$LOCALAPPDATA/pkl/repl-history`	none

Package cache

~/.cache/pkl

$LOCALAPPDATA/pkl/Cache

none

Settings file

~/.config/pkl/settings.pkl

$APPDATA/pkl/settings.pkl

~/.pkl/settings.pkl

CA certificates

~/.config/pkl/cacerts

$APPDATA/pkl/cacerts

~/.pkl/cacerts

REPL history

~/.local/state/pkl/repl-history

$LOCALAPPDATA/pkl/repl-history

none

On every OS, these locations can be overridden with XDG-style env vars. For example, setting XDG_CACHE_HOME will configure the cache directory.

Note that the existing ~/.pkl/cache directory is ignored, so Pkl will download packages to populate its cache if configured to do so.

Native pkl and pkldoc binaries for Intel Mac systems are no longer published with Pkl releases.

To continue running new Pkl releases on these systems, use an appropriate Java runtime and the jpkl and jpkldoc Java executables.

We would like to thank the contributors to this release (in alphabetical order):