Skip to main content
When integrating Taskfile into a CI/CD pipeline, you can reference remote Taskfiles directly without checking them into the repo. Supported remote reference formats:
  • https://raw.githubusercontent.com/<username>/<repo>/<branch>/<path>/Taskfile.yml
  • https://github.com/<username>/<repo>.git//<path>/Taskfile.yml?ref=main (note: // before the path is required)
  • [email protected]/<username>/<repo>.git//<path>/Taskfile.yml?ref=main
1

Enable the remote Taskfile feature

This feature is experimental and must be enabled via an environment variable:
export TASK_X_REMOTE_TASKFILES=1
2

Include or execute a remote Taskfile

Option 1 — Run directly from the CLI:
task --taskfile https://raw.githubusercontent.com/go-task/task/main/website/static/Taskfile.yml
Option 2 — Include in your Taskfile:
Taskfile.yml
version: '3'

includes:
  # Without authentication
  app-remote: https://raw.githubusercontent.com/go-task/task/main/website/static/Taskfile.yml
  # With token authentication
  app-remote-auth: https://{{.TOKEN}}@raw.githubusercontent.com/go-task/task/main/website/static/Taskfile.yml

task app-remote

export TOKEN=<your-token>
task app-remote-auth
3

Force refresh the remote Taskfile cache (optional)

By default, remote Taskfiles are cached in the .task directory. To ensure you always use the latest version:
task --download -y  # Force re-download the remote Taskfile
task --clear-cache  # Clear all remote cache

Build docs developers (and LLMs) love

Get started for freeTalk to us