Question 1

how to set up a global maskfile for system tasks

Accepted Answer

Create a maskfile.md in your home directory and use an alias like 'alias wask="mask --maskfile ~/maskfile.md"' to run commands from anywhere, as suggested in the README's tip for global utilities.

Question 2

mask vs just for task running

Accepted Answer

Mask offers nested subcommands and markdown-based readability, while Just focuses on simplicity and speed with a dedicated syntax. Mask is better for documentation-heavy workflows, but Just might be preferred for minimal overhead and faster execution in script-heavy projects.

Question 3

how to handle errors in mask scripts

Accepted Answer

Mask inherits the script's exit code, so you can use standard shell error handling (like && or set -e). For example, chaining commands with && will stop on the first error, as shown in the 'ci' command example in the README.

Question 4

can mask run tasks in parallel

Accepted Answer

No, mask executes commands sequentially within a script. For parallel execution, you'd need to implement it manually in the script using language-specific features (e.g., background processes in shell), which isn't built into mask itself.

Question 5

how to use environment variables in mask scripts

Accepted Answer

Mask injects arguments and flags as environment variables (e.g., $port for a --port flag) and provides utilities like $MASKFILE_DIR for path resolution. You can also set custom env vars within the script, as demonstrated in the examples.

Question 6

mask integration with CI/CD like GitHub Actions

Accepted Answer

Mask can be installed via precompiled binaries or package managers, and you can run mask commands directly in CI scripts. However, it lacks native plugins or specific integrations, requiring manual setup similar to other CLI tools.

mask

What is mask?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Open Source Alternative To

Frequently Asked Questions