Flux

Declarative task runner with dependency management. Modern alternative to Makefile and package.json scripts.

flux build        # Run task
flux build,test   # Run in parallel
flux watch build  # Watch for changes

Quick Start

# Install
cargo install flux-core

# Create config
cat > flux.yaml << 'EOF'
build:
  command: "cargo build --release"
  runner: "cargo"

test:
  command: "cargo test"
  depends_on: ["build"]
EOF

# Run
flux build
flux test   # Runs build first, then test

Features

Usage

flux <task>              # Run single task
flux <t1,t2,t3>          # Run parallel
flux watch <task> [dir]  # Watch mode
flux <task> --dry-run    # Simulate
flux graph               # Show dependency tree
flux runners             # List all runners

Configuration Example

dev:
  command: "cargo run"
  description: "Start dev server"

build:
  command: "cargo build --release"
  depends_on: ["test"]
  pre_hook: "echo 'Building...'"

test:
  command: "cargo test"
  runner: "cargo"

publish:
  command: "cargo publish"
  depends_on: ["build", "lint"]
  post_hook: "echo 'Published!'"

Installation

Cargo

cargo install flux-core

Docker

docker run --rm -v $(pwd):/workspace ghcr.io/yunusgungor/flux:latest help

From Source

git clone https://github.com/yunusgungor/flux.git
cd flux && cargo build --release
sudo cp target/release/flux-core /usr/local/bin/flux

Why Flux?

Documentation

• Full Documentation
• Docker Guide
• WASM Guide
• Examples

License

MIT © Yunus Güngör