CONFIGURATION
March 25, 2026 ยท View on GitHub
tuco uses YAML syntax for configuration files.
tuco.yaml
tuco reads a configuration file tuco.yaml in the current working directory.
debug
Default: false
When true, enables additional logs.
Example:
debug: true
artifacts
Default: "bin"
Customize the toplevel directory for binary artifacts.
Example:
artifacts: "dist"
banner
Required, nonblank.
Software application name.
Example:
banner = "hello"
jobs
Default: 4
Customize concurrent Go worker limit.
Example:
jobs: 8
go_args
Default: (empty)
Supply additional CLI arguments to go build... commands.
Example:
go_args:
- "-v"
Go Ports
Target Go ports.
To enumerate available ports, run go tool dist list.
os
Enable GOOS values.
Example:
# Skip mobile SDKs
os:
- "aix"
# - "android"
- "darwin"
- "dragonfly"
- "freebsd"
- "illumos"
# - "ios"
- "js"
- "linux"
- "netbsd"
- "openbsd"
- "plan9"
- "solaris"
- "wasip1"
- "windows"
arch
Enable GOARCH values.
Example:
arch:
- "386"
- "amd64"
- "arm"
- "arm64"
- "loong64"
- "mips"
- "mips64"
- "mips64le"
- "mipsle"
- "ppc64"
- "ppc64le"
- "riscv64"
- "s390x"
- "wasm"
port_excludes
Default: (empty)
Skip named Go ports.
Useful for disabling broken or deprecated ports.
Example:
port_excludes:
- "darwin/amd64"
archive_excludes
Default:
- ".DS_Store" # Finder
- "Thumbs.db" # Explorer
Skips corresponding file path patterns when archiving binaries.
Syntax: Glob
Example:
excludes:
- ".DS_Store" # Finder
- ".directory" # Dolpin
- "Thumbs.db" # Explorer