Skip to content

feat: enable remote taskfiles - #2906

Merged
pd93 merged 12 commits into
mainfrom
enable-remote-taskfiles
Aug 13, 2026
Merged

feat: enable remote taskfiles#2906
pd93 merged 12 commits into
mainfrom
enable-remote-taskfiles

Conversation

@pd93

@pd93 pd93 commented Jul 2, 2026

Copy link
Copy Markdown
Member

Related to #1317

This PR enables the remote taskfile functionality globally without the need for an experiment flag/config. If users continue to attempt to enable the remote taskfile experiment, they will be presented with a warning telling them that they no longer need to do this.

Additionally, large changes have been made to the documentation on the website. Namely:

  • There is a new dedicated page for Remote Taskfiles (consisting mostly of the same content as the experiment doc)
  • The guide has been updated to show a couple of basic things (this then links to the full doc)
  • The configuration that was previously in the experiment doc has been moved to the reference docs for the CLI/envinroment variables/config files respectively.

@vmaerten
vmaerten self-requested a review July 2, 2026 18:31

@vmaerten vmaerten left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice !
You need to update completions files :

if __task_is_experiment_enabled "REMOTE_TASKFILES"; then
&
if ($experiments -match '\* REMOTE_TASKFILES:.*on') {
&
complete -c $GO_TASK_PROGNAME -n "__task_is_experiment_enabled REMOTE_TASKFILES" -l offline -d 'use only local or cached Taskfiles'

@pd93

pd93 commented Jul 3, 2026

Copy link
Copy Markdown
Member Author

Nice ! You need to update completions files :

Thanks! Updated. Completion scripts aren't my forte, so please check them 😆

Also fixed the broken links.

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Enables Remote Taskfiles as a generally available feature by removing the experiment gate in core code, promoting related CLI flags/completions to always be available, and restructuring website documentation to move content from the experiment page into first-class docs and reference sections.

Changes:

  • Remove the runtime experiment check that previously blocked remote Taskfile nodes.
  • Make remote-related CLI flags and shell completions always available (no experiment gating).
  • Add/update website docs: new Remote Taskfiles page, guide snippets, and expanded reference docs for remote config/env/CLI.

Reviewed changes

Copilot reviewed 18 out of 18 changed files in this pull request and generated 13 comments.

Show a summary per file
File Description
website/src/public/schema-taskrc.json Removes REMOTE_TASKFILES from the experiments schema to reflect GA status.
website/src/docs/remote-taskfiles.md Adds a dedicated Remote Taskfiles documentation page.
website/src/docs/reference/environment.md Adds a “Remote Taskfile Variables” section.
website/src/docs/reference/config.md Documents remote.* configuration keys in reference docs.
website/src/docs/reference/cli.md Documents remote-related CLI flags in the CLI reference.
website/src/docs/guide.md Adds guide-level examples for running/including remote Taskfiles and formatting tweaks.
website/src/docs/experiments/remote-taskfiles.md Replaces experiment content with a pointer to released docs/changelog.
website/.vitepress/config.ts Adds “Remote Taskfiles” to the docs navigation.
taskfile/node.go Removes the experiment-enabled check for remote nodes.
task_test.go Removes test-only experiment enabling for remote include/http tests.
internal/flags/flags.go Registers remote flags unconditionally (previously behind experiment).
experiments/experiments.go Treats RemoteTaskfiles as a released (inactive) experiment for warning-only behavior.
experiments/experiment.go Adds “released/abandoned” inactive experiment helpers and richer inactive reason tracking.
experiments/errors.go Improves inactive experiment error messaging with an optional reason.
completion/zsh/_task Makes remote flags/completions always available in zsh completion.
completion/ps/task.ps1 Makes remote flags/completions always available in PowerShell completion.
completion/fish/task.fish Makes remote flags/completions always available in fish completion.
.taskrc.yml Removes REMOTE_TASKFILES from the repo’s default experiments list.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread internal/flags/flags.go Outdated
Comment thread website/src/docs/remote-taskfiles.md Outdated
Comment thread website/src/docs/remote-taskfiles.md
Comment thread website/src/docs/remote-taskfiles.md Outdated
Comment thread website/src/docs/remote-taskfiles.md Outdated
Comment thread website/src/docs/reference/config.md
Comment thread website/src/docs/reference/config.md
Comment thread website/src/docs/reference/config.md
Comment thread website/src/docs/guide.md
Comment thread website/src/docs/guide.md Outdated

@vmaerten vmaerten left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me! 🔥

@arturict

Copy link
Copy Markdown

Taskfile timeout docs and implementation update helpful. Could you include one sample command that demonstrates fallback/timeout semantics.

@pd93
pd93 force-pushed the enable-remote-taskfiles branch from cb07b48 to c95fcd8 Compare August 13, 2026 13:26
@pd93
pd93 merged commit 87076b1 into main Aug 13, 2026
20 checks passed
@pd93
pd93 deleted the enable-remote-taskfiles branch August 13, 2026 13:38
pd93 added a commit that referenced this pull request Aug 13, 2026
vmaerten added a commit that referenced this pull request Aug 13, 2026
…emote flags

The remote Taskfile flags left the experiment in #2906, but the legacy Bash, Fish, Zsh and PowerShell wrappers this branch restores still gated them behind `__task_is_experiment_enabled REMOTE_TASKFILES`.
vmaerten added a commit that referenced this pull request Aug 13, 2026
… official

Remote includes are resolved for everyone since #2906, so a keystroke on a Taskfile including an uncached remote one is now a real freeze: without the offline override it waits the full --timeout and hits the network. The experiment-gated flag test moved to --force-all, the only flag still behind an experiment.
vmaerten added a commit that referenced this pull request Aug 13, 2026
…emote flags

The remote Taskfile flags left the experiment in #2906, but the legacy Bash, Fish, Zsh and PowerShell wrappers this branch restores still gated them behind `__task_is_experiment_enabled REMOTE_TASKFILES`.
vmaerten added a commit that referenced this pull request Aug 13, 2026
… official

Remote includes are resolved for everyone since #2906, so a keystroke on a Taskfile including an uncached remote one is now a real freeze: without the offline override it waits the full --timeout and hits the network. The experiment-gated flag test moved to --force-all, the only flag still behind an experiment.
vmaerten added a commit that referenced this pull request Aug 13, 2026
…emote flags

The remote Taskfile flags left the experiment in #2906, but the legacy Bash, Fish, Zsh and PowerShell wrappers this branch restores still gated them behind `__task_is_experiment_enabled REMOTE_TASKFILES`.
vmaerten added a commit that referenced this pull request Aug 13, 2026
… official

Remote includes are resolved for everyone since #2906, so a keystroke on a Taskfile including an uncached remote one is now a real freeze: without the offline override it waits the full --timeout and hits the network. The experiment-gated flag test moved to --force-all, the only flag still behind an experiment.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants