foy

Foy is a lightweight, general‑purpose task runner and build tool that runs from the command line. It lets developers define tasks in a `Foyfile.js` or `Foyfile.ts`, using a simple API that supports asynchronous, promise‑based operations. Tasks can invoke shell‑like commands, manipulate the file system, set environment variables, and execute other programs, while built‑in utilities such as `fs`, `logger`, and `exec` provide common workflow helpers.

The tool targets developers who need a minimal yet modern alternative to larger build systems. It offers features like option parsing, strict validation, namespaces, dependency handling, and watch mode for continuous builds. Integration with TypeScript is supported through tsx, @swc‑node/register, or ts‑node, and the package size is small compared with other task runners.

Foy can be installed locally or globally via npm or yarn, and it includes auto‑completion for Zsh/Bash. Its API enables composing tasks, running tasks within tasks, and using lifecycle hooks, making it suitable for CI environments and custom compilation pipelines.