README.md

July 14, 2025 · View on GitHub

Braisé Banner Braisé Banner

Build Status Release License

Run your tasks like a chef! 👨‍🍳

What is this?

Yet another task runner, because apparently the world needed one more. But hey, at least this one has types and doesn't make you want to cry when debugging your build scripts.

Features

  • Types (revolutionary, I know)
  • Dependencies
  • Parallel execution
  • Built-in modules (input, env, git, fs and cpu - the essentials)
  • LSP support
  • Dry run mode (for the commitment-phobic)

Quick Start

Install it:

with install.sh

curl -sSL https://braise.cstef.dev/install.sh | INCLUDE_DEV=true bash

with cargo

cargo install --git https://github.com/cestef/braise --branch main --bins

with brew

brew install cestef/tap/braise

Create a Braisefile:

recipe "hello" {
    param name: string = "World"
    print "Hello, ${name}!"
}

Run it:

braise hello --name "Chef"

Why Not Just Use...?

  • Make: 1976 is calling
  • npm scripts: JSON isn't a programming language
  • Bash scripts: Good luck debugging that
  • Justfile: Not that bad, not "batteries included" (missing LSP, built-in modules, etc.)

Contributing

Found a bug? Great! Open an issue. Want to add a feature? Even better! Submit a PR.