ctrl+shift+p filters: :st2 :st3 :win :osx :linux
Browse

Taskfile

by biozz ST4

A Sublime Text 4 plugin for running Taskfile tasks

Details

Installs

  • Total 347
  • Win 135
  • Mac 139
  • Linux 73
Oct 31 Oct 30 Oct 29 Oct 28 Oct 27 Oct 26 Oct 25 Oct 24 Oct 23 Oct 22 Oct 21 Oct 20 Oct 19 Oct 18 Oct 17 Oct 16 Oct 15 Oct 14 Oct 13 Oct 12 Oct 11 Oct 10 Oct 9 Oct 8 Oct 7 Oct 6 Oct 5 Oct 4 Oct 3 Oct 2 Oct 1 Sep 30 Sep 29 Sep 28 Sep 27 Sep 26 Sep 25 Sep 24 Sep 23 Sep 22 Sep 21 Sep 20 Sep 19 Sep 18 Sep 17 Sep 16
Windows 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1
Mac 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 1 0 2 0 0 0 0 0 0 0 0
Linux 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0

Readme

Source
raw.​githubusercontent.​com

Sublime Taskfile

Package Control

A Sublime Text 4 plugin for running tasks from Taskfile. It adds Taskfile: Run Task to your command palette and you can select which task to run. The output of the task is then displayed in the build output panel at the bottom.

It is also possible to initialize the Taskfile with Taskfile: Init command, which basically does task -i in one of the project directories you choose.

Usage

  • made for Sublime Text 4, including the Python 3.14 plugin host
  • has no external dependencies (other than task command)
  • properly handles multiple open directories
  • supports taskfile includes
  • does not and will not ship any custom syntax definitions (see installation notes for more details)

Installation

First, install Taskfile command.

Then use Package Control: Install Package command and search for Taskfile.

If you want to have a hints on which keys are available and what they do, there is an official JSON schema for Taskfile, which can be loaded automatically once you install LSP and LSP-yaml packages.

Compatibility

Supports Python 3.8 through 3.14. Sublime Text supplies its own Python runtime; you do not need to install Python to use this plugin. Sublime Text 4213 and newer ship Python 3.14, replacing Python 3.8.

The package deliberately keeps .python-version set to 3.8: Sublime Text maps this to Python 3.14 on new builds and Python 3.8 on older Sublime Text 4 builds. See the Sublime Text API environments documentation.

Task must be available on Sublime Text's PATH. The plugin recognizes .yml, .yaml, lowercase and .dist Taskfile names in open project folders.

Contributing

You are welcome to submit pull requests with bug fixes and improvements.

Use Python 3.10 or newer for development tooling (Python 3.14 recommended). The .python-version file selects Sublime's plugin host, so explicitly select your development interpreter when using tools such as pyenv or uv.

poetry env use python3.14
poetry install --no-root
poetry run python -m unittest discover -s tests -v
poetry run black .
poetry run isort .
poetry run autoflake --check --recursive Taskfile.py tests

CI tests Python 3.8–3.14 on Linux, macOS and Windows using a stub of the Sublime API. Changes to editor behavior should also be checked inside Sublime Text.

For releases, update the version in pyproject.toml and add a dated entry to CHANGELOG.md. Use that entry for the GitHub release description. Reserve Package Control upgrade messages for breaking changes, migration steps or other changes requiring user attention; routine fixes only need release notes.