1
0
mirror of https://github.com/go-task/task.git synced 2025-07-17 01:43:07 +02:00
This commit is contained in:
Valentin Maerten
2025-05-07 11:59:13 +02:00
parent 41c3e52a53
commit 890c9ea875

View File

@ -0,0 +1,31 @@
---
slug: /reference/schema-taskrc
sidebar_position: 4
toc_min_heading_level: 2
toc_max_heading_level: 5
---
# Schema taskrc Reference
The `.taskrc` file is the configuration file used by Task. It can have either a `.yml` or `.yaml` extension and can be located in two places:
- **Local** – at the root of the project.
- **Global** – in the user's HOME directory.
When both local and global `.taskrc.yml` files are present, their contents are merged. If the same key exists in both files, the value from the local file takes precedence over the global one.
## Schema
| Attribute | Type | Default | Description |
|---------------|-------------------------------------|---------|------------------------------------------------------|
| `version` | `string` | | Version of the Taskfile. The current version is `3`. |
| `experiments` | [`map[string]number`](#experiments) | | Experiments to enable or disable |
## Experiments
| Attribute | Type | Default | Description |
|--------------------|----------|---------|----------------------------------------------------------|
| `REMOTE_TASKFILES` | `number` | | Enable (1) or disable (0) the remote taskfile experiment |
| `ENV_PRECEDENCE` | `number` | | Enable (1) or disable (0) the env precedence experiment. |
| `GENTLE_FORCE` | `number` | | Enable (1) or disable (0) the gentle force experiment. |