task [flags...] [task...]

Usage: task [flags...] [task...]

Runs the specified task(s). Falls back to the "default" task if no task name
was specified, or lists all tasks if an unknown task name was specified.

Example: 'task hello' with the following 'Taskfile.yml' file will generate an
'output.txt' file with the content "hello".

'''
version: '3'
tasks:
  hello:
    cmds:
      - echo "I am going to write a file named 'output.txt' now."
      - echo "hello" > output.txt
    generates:
      - output.txt
'''

Options:
      --cacert string               Path to a custom CA certificate for HTTPS connections.
      --cert string                 Path to a client certificate for HTTPS connections.
      --cert-key string             Path to a client certificate key for HTTPS connections.
      --clear-cache                 Clear the remote cache.
  -c, --color                       Colored output. Enabled by default. Set flag to false or use NO_COLOR=1 to disable. (default true)
      --completion string           Generates shell completion script.
  -C, --concurrency int             Limit number of tasks to run concurrently.
  -d, --dir string                  Sets the directory in which Task will execute and look for a Taskfile.
      --disable-fuzzy               Disables fuzzy matching for task names.
      --download                    Forces task to download remote Taskfiles and ignore any cached versions.
  -n, --dry                         Compiles and prints tasks in the order that they would be run, without executing them.
  -x, --exit-code                   Pass-through the exit code of the task command.
      --experiments                 Lists all the available experiments and whether or not they are enabled.
      --expiry duration             Expiry duration for cached remote Taskfiles.
  -F, --failfast                    When running tasks in parallel, stop all tasks if one fails.
  -f, --force                       Forces execution even when the task is up-to-date.
  -g, --global                      Runs global Taskfile, from $HOME/{T,t}askfile.{yml,yaml}.
  -h, --help                        Shows Task usage.
  -i, --init                        Creates a new Taskfile.yml in the current folder.
      --insecure                    Forces Task to download Taskfiles over insecure connections.
      --interactive                 Prompt for missing required variables.
  -I, --interval duration           Interval to watch for changes.
  -j, --json                        Formats task list as JSON.
  -l, --list                        Lists tasks with description of current Taskfile.
  -a, --list-all                    Lists tasks with or without a description.
      --nested                      Nest namespaces when listing tasks as JSON
      --no-status                   Ignore status when listing tasks as JSON
      --offline                     Forces Task to only use local or cached Taskfiles.
  -o, --output string               Sets output style: [interleaved|group|prefixed].
      --output-group-begin string   Message template to print before a task's grouped output.
      --output-group-end string     Message template to print after a task's grouped output.
      --output-group-error-only     Swallow output from successful tasks.
  -p, --parallel                    Executes tasks provided on command line in parallel.
      --remote-cache-dir string     Directory to cache remote Taskfiles.
  -s, --silent                      Disables echoing.
      --sort string                 Changes the order of the tasks when listed. [default|alphanumeric|none].
      --status                      Exits with non-zero exit code if any of the given tasks is not up-to-date.
      --summary                     Show summary about a task.
  -t, --taskfile string             Choose which Taskfile to run. Defaults to "Taskfile.yml".
      --temp-dir string             Sets the directory used to store Task temporary files, such as checksums. Relative paths are relative to the root Taskfile.
      --timeout duration            Timeout for downloading remote Taskfiles. (default 10s)
      --trusted-hosts strings       List of trusted hosts for remote Taskfiles (comma-separated).
  -v, --verbose                     Enables verbose mode.
      --version                     Show Task version.
  -w, --watch                       Enables watch of the given task.
  -y, --yes                         Assume "yes" as answer to all prompts.

task --version

3.54.0

mkdir -p /tmp/empty-demo && cd /tmp/empty-demo && task; echo exit=$?

task: No Taskfile found at "" (or any of the parent directories). Run `task --init` to create a new Taskfile.
exit=100

task

task: Available tasks for this project:
* build:                 编译产物（sources/generates 增量演示）
* cli-args:              CLI_ARGS 演示
* default:               默认任务（显示帮助）
* hello:                 打印问候语
* backend:build:         编译后端服务

task --list

task: Available tasks for this project:
* build:        编译产物（sources/generates 增量演示）
* hello:        打印问候语
* backend:build: 编译后端服务

task --list-all

task: Available tasks for this project:
* build:        编译产物（sources/generates 增量演示）
* cli-args:     CLI_ARGS 演示
* default:      默认任务（显示帮助）
* backend:build: 编译后端服务

task --list --json | head -c 600

{
  "tasks": [
    {
      "name": "build",
      "task": "build",
      "desc": "编译产物（sources/generates 增量演示）",
      "aliases": [],
      "up_to_date": true,
      "location": {
        "line": 38,
        "column": 3,
        "taskfile": "/opt/demo/Taskfile.yml"
      }
    },

task --summary build

task: build

编译产物（sources/generates 增量演示）

vars:
  APP_NAME: "demo-app"
  GREETING: "Hello"
  COMMIT_HASH: sh: echo a1b2c3d

env:
  APP_ENV: "production"
  DATABASE_URL: "postgres://admin:q1w2e3r4@localhost:5432/demo"

commands:
 - mkdir -p dist
 - cp src/app.txt dist/app.txt
 - echo "built "

task --init

Taskfile created: Taskfile.yml

# yaml-language-server: $schema=https://taskfile.dev/schema.json

version: '3'

vars:
  GREETING: Hello, world!

tasks:
  default:
    desc: Print a greeting message
    cmds:
      - echo "{{.GREETING}}"
    silent: true

task

Hello, world!

task hello

task: [hello] echo 'Hello World! (demo-app v3)'
Hello World! (demo-app v3)

task requires-demo ENVIRONMENT=production

task: [requires-demo] echo "deploy to production"
deploy to production

task cli-args -- --foo bar

task: [cli-args] echo "args are --foo bar"
args are --foo bar

task build

task: Task "build" is up to date

task --force hello

task: [hello] echo 'Hello World! (demo-app v3)'
Hello World! (demo-app v3)

task --dry build

task: [build] mkdir -p dist
task: [build] cp src/app.txt dist/app.txt
task: [build] echo "built a1b2c3d"

task --parallel hello cli-args

task: [cli-args] echo "args are "
task: [hello] echo 'Hello World! (demo-app v3)'
args are 
Hello World! (demo-app v3)

task --silent hello

Hello World! (demo-app v3)

task --output prefixed --parallel hello cli-args

task: [cli-args] echo "args are "
task: [hello] echo 'Hello World! (demo-app v3)'
[cli-args] args are 
[hello] Hello World! (demo-app v3)

task -d /opt/demo/backend build

task --status build; echo exit=$?

exit=0

task -w build

task: Started watching for tasks: build
task: Task "build" is up to date
task: task "build" finished running
task: [build] mkdir -p dist
task: [build] cp src/app.txt dist/app.txt
task: [build] echo "built a1b2c3d"
built a1b2c3d
task: task "build" finished running

task --temp-dir .task-cache build

task --completion bash | head -5

# vim: set tabstop=2 shiftwidth=2 expandtab:
#
# Thin wrapper around `task __complete`: all suggestion logic lives in the Go engine.

TASK_CMD="${TASK_EXE:-task}"

task --experiments

* GENTLE_FORCE:   off
* ENV_PRECEDENCE: off

task --version

3.54.0