• Fixed a bug where some special variables caused a type error when used in global variables (#2106, #2107 by @pd93).

• Made --init less verbose by default and respect --silent and --verbose flags (#2009, #2011 by @HeCorr).
• --init now accepts a file name or directory as an argument (#2008, #2018 by @HeCorr).
• Fix a bug where an HTTP node's location was being mutated incorrectly (#2007 by @jeongukjae).
• Fixed a bug where allowed values didn't work with dynamic var (#2032, #2033 by @vmaerten).
• Use only the relevant checker (timestamp or checksum) to improve performance (#2029, #2031 by @vmaerten).
• Print warnings when attempting to enable an inactive experiment or an active experiment with an invalid value (#1979, #2049 by @pd93).
• Refactored the experiments package and added tests (#2049 by @pd93).
• Show allowed values when a variable with an enum is missing (#2027, #2052 by @vmaerten).
• Refactored how snippets in error work and added tests (#2068 by @pd93).
• Fixed a bug where errors decoding commands were sometimes unhelpful (#2068 by @pd93).
• Fixed a bug in the Taskfile schema where defer statements in the shorthand cmds syntax were not considered valid (#2068 by @pd93).
• Refactored how task sorting functions work (#1798 by @pd93).
• Added a new .taskrc.yml (or .taskrc.yaml) file to let users enable experiments (similar to .env) (#1982 by @vmaerten).
• Added new Getting Started docs (#2086 by @pd93).
• Allow matrix to use references to other variables (#2065, #2069 by @pd93).
• Fixed a bug where, when a dynamic variable is provided, even if it is not used, all other variables become unavailable in the templating system within the include (#2092 by @vmaerten).

Package API

Unlike our CLI tool, Task's package API is not currently stable. In an effort to ease the pain of breaking changes for our users, we will be providing changelogs for our package API going forwards. The hope is that these changes will provide a better long-term experience for our users and allow to stabilize the API in the future. #121 now tracks this piece of work.

• Bumped the minimum required Go version to 1.23 (#2059 by @pd93).
• task.InitTaskfile (#2011, ff8c913 by @HeCorr and @pd93)
  • No longer accepts an io.Writer (output is now the caller's responsibility).
  • The path argument can now be a filename OR a directory.
  • The function now returns the full path of the generated file.
• TaskfileDecodeError.WithFileInfo now accepts a string instead of the arguments required to generate a snippet (#2068 by @pd93).
  • The caller is now expected to create the snippet themselves (see below).
• TaskfileSnippet and related code moved from the errors package to the taskfile package (#2068 by @pd93).
• Renamed TaskMissingRequiredVars to TaskMissingRequiredVarsError (#2052 by @vmaerten).
• Renamed TaskNotAllowedVars to TaskNotAllowedVarsError (#2052 by @vmaerten).
• The taskfile.Reader is now constructed using the functional options pattern (#2082 by @pd93).
• Removed our internal logger.Logger from the entire taskfile package (#2082 by @pd93).
  • Users are now expected to pass a custom debug/prompt functions into taskfile.Reader if they want this functionality by using the new WithDebugFunc and WithPromptFunc functional options.
• Remove Range functions in the taskfile/ast package in favour of new iterator functions (#1798 by @pd93).
• ast.Call was moved from the taskfile/ast package to the main task package (#2084 by @pd93).
• ast.Tasks.FindMatchingTasks was moved from the taskfile/ast package to the task.Executor.FindMatchingTasks in the main task package (#2084 by @pd93).
• The Compiler and its GetVariables and FastGetVariables methods were moved from the internal/compiler package to the main task package (#2084 by @pd93).

• Fixed an issue where dynamic variables were not properly logged in verbose mode (#1920, #1921 by @mgbowman).
• Support silent for defer statements (#1877, #1879 by @danilobuerger).
• Added an option to exclude some tasks from being included (#1859 by @vmaerten).
• Fixed an issue where a required variable was incorrectly handled in a template function (#1950, #1962 by @vmaerten).
• Expose a new TASK_DIR special variable, which will contain the absolute path of task directory. (#1959, #1961 by @vmaerten).
• Fixed fatal bugs that caused concurrent map writes (#1605, #1972, #1974 by @pd93, @GrahamDennis and @trim21).
• Refactored internal ordered map implementation to use github.com/elliotchance/orderedmap (#1797 by @pd93).
• Fixed a bug where variables defined at the task level were being ignored in the requires section. (#1960, #1955, #1768 by @vmaerten and @mokeko)
• The CHECKSUM and TIMESTAMP variables are now accessible within cmds (#1872 by @niklasr22).
• Updated installation docs and added pip installation method (#935, #1989 by @pd93).
• Fixed a bug where dynamic variables could not access environment variables (#630, #1869 by @rohm1 and @pd93).
• Disable version check for use as an external library (#1938 by @leaanthony).

• Fixed a security issue in git-urls by switching to the maintained fork chainguard-dev/git-urls (#1917 by @AlekSi).
• Added missing platforms property to cmds that use for (#1915 by @dkarter).
• Added misspell linter to check for misspelled English words (#1883 by @christiandins).

If you like this project, consider spreading the word or sponsoring the project.

• Fixed output of some functions (e.g. splitArgs/splitLines) not working in for loops (#1822, #1823 by @stawii).
• Added a new TASK_OFFLINE environment variable to configure the --offline flag and expose it as a special variable in the templating system (#1470, #1716 by @vmaerten and @pd93).
• Fixed a bug where multiple remote includes caused all prompts to display without waiting for user input (#1832, #1833 by @vmaerten and @pd93).
• When using the "Remote Taskfiles" experiment, you can now include Taskfiles from Git repositories (#1652 by @vmaerten).
• Improved the error message when a dotenv file cannot be parsed (#1842 by @pbitty).
• Fix issue with directory when using the remote experiment (#1757 by @pbitty).
• Fixed an issue where a special variable was used in combination with a dotenv file (#1232, #1810 by @vmaerten).
• Refactor the way Task reads Taskfiles to improve readability (#1771 by @pbitty).
• Added a new option to ensure variable is within the list of values (#1827 by @vmaerten).
• Allow multiple prompts to be specified for a task (#1861, #1866 by @mfbmina).
• Added new template function: numCPU, which returns the number of logical CPUs usable (#1890, #1887 by @Amoghrd).
• Fixed a bug where non-nil, empty dynamic variables are returned as an empty interface (#1903, #1904 by @pd93).

• Fix dynamic variables not working properly for a defer: statement (#1803, #1818 by @vmaerten).

• Added Renovate configuration to automatically create PRs to keep dependencies up to date (#1783 by @vmaerten).
• Fixed a bug where the help was displayed twice (#1805, #1806 by @vmaerten).
• Fixed a bug where ZSH and PowerShell completions did not work when using the recommended method. (#1813, #1809 by @vmaerten and @shirayu)
• Fix variables not working properly for a defer: statement (#1803, #1814 by @vmaerten and @andreynering).

• Added Env Precedence Experiment (#1038, #1633 by @vmaerten).
• Added a CI lint job to ensure that the docs are updated correctly (#1719 by @vmaerten).
• Updated minimum required Go version to 1.22 (#1758 by @pd93).
• Expose a new EXIT_CODE special variable on defer: when a command finishes with a non-zero exit code (#1484, #1762 by @dorimon-1 and @andreynering).
• Expose a new ALIAS special variable, which will contain the alias used to call the current task. Falls back to the task name. (#1764 by @DanStory).
• Fixed TASK_REMOTE_DIR environment variable not working when the path was absolute. (#1715 by @vmaerten).
• Added an option to declare an included Taskfile as flattened (#1704 by @vmaerten).
• Added a new --completion flag to output completion scripts for various shells (#293, #1157 by @pd93).
  • This is now the preferred way to install completions.
  • The completion scripts in the completion directory are now deprecated.
• Added the ability to loop over a matrix of values (#1766, #1767, #1784 by @pd93).
• Fixed a bug in fish completion where aliases were not displayed (#1781, #1782 by @vmaerten).
• Fixed panic when having a flattened included Taskfile that contains a default task (#1777, #1778 by @vmaerten).
• Optimized file existence checks for remote Taskfiles (#1713 by @vmaerten).

• Added TASK_EXE special variable (#1616, #1624 by @pd93 and @andreynering).
• Some YAML parsing errors will now show in a more user friendly way (#1619 by @pd93).
• Prefixed outputs will now be colorized by default (#1572 by @AlexanderArvidsson)
• References are now generally available (no experiments required) (#1654 by @pd93).
• Templating functions can now be used in references (#1645, #1654 by @pd93).
• Added a new templating reference page to the documentation (#1614, #1653 by @pd93).
• If using the Map Variables experiment (1), references are available by prefixing a string with a # (#1654 by @pd93).
• If using the Map Variables experiment (2), the yaml and json keys are no longer available (#1654 by @pd93).
• Added a new TASK_REMOTE_DIR environment variable to configure where cached remote Taskfiles are stored (#1661 by @vmaerten).
• Added a new --clear-cache flag to clear the cache of remote Taskfiles (#1639 by @vmaerten).
• Improved the readability of cached remote Taskfile filenames (#1636 by @vmaerten).
• Starting releasing a binary for the riscv64 architecture on Linux (#1699 by @mengzhuo).
• Added CLI_SILENT and CLI_VERBOSE variables (#1480, #1669 by @Vince-Smith).
• Fixed a couple of bugs with the prompt: feature (#1657 by @pd93).
• Fixed JSON Schema to disallow invalid properties (#1657 by @pd93).
• Fixed version checks not working as intended (#872, #1663 by @vmaerten).
• Fixed a bug where included tasks were run multiple times even if run: once was set (#852, #1655 by @pd93).
• Fixed some bugs related to column formatting in the terminal (#1350, #1637, #1656 by @vmaerten).

• Fixed a bug where an empty Taskfile would cause a panic (#1648 by @pd93).
• Fixed a bug where includes Taskfile variable were not being merged correctly
  (#1643, #1649 by @pd93).