Run scripts and binaries

aubr runs project scripts, aube exec runs installed binaries, and aubx runs one-off tools. Script and exec commands install missing or stale dependencies before running.

Command	Lookup order
aubr <name> / aube run <name>	package.json script, then local binary
aube exec <name>	Binary on the project command path
aubx <name> / aube dlx <name>	Local binary, then a throwaway install

Scripts

aubr build
aube test
aube start
aube stop
aube restart

aubr is shorthand for aube run. Before running a script, aube checks node_modules/.aube-state. If the manifest or lockfile changed, aube installs first. Use --no-install when you want to skip that check.

aube run --no-install build
aube test --no-install

Use --if-present for optional scripts:

aube run --if-present lint

When no package.json script matches, aube run <name> falls back to a local binary with the same name in node_modules/.bin. Scripts still win over bins, so a project can override a tool command with its own script.

Forward arguments

Put aube options before the script name; arguments after the name go to the script:

aube run --no-install test --watch

For exec, use -- to separate tool arguments when needed:

aube exec tsc -- --noEmit

Echoed command lines

Before running a script, aube prints its command line to stderr, prefixed with $ — the same thing npm, pnpm, and bun do:

$ aubr build
$ tsc -p .

pre/post scripts each get their own line, and forwarded args are appended so the echoed line reproduces the run exactly. It goes to stderr, so aube run print-json > out.json still captures only the script's own output.

Pass --silent (or -s, or --loglevel silent) to suppress the echo while keeping the script's own stdout and stderr:

aube run --silent build

In --parallel workspace runs the echoed line carries the same <package>: prefix as the rest of that package's output.

Local binaries

aube exec vitest
aube exec tsc -- --noEmit

exec runs a binary from the project context with node_modules/.bin on PATH.

Non-shell aube exec, the aube run bin fallback, and non-shell aube dlx detect native package targets and launch them directly. Shell-routed commands, global bins, and direct .bin invocation continue through installed wrappers; on Unix, directly launched native targets must be executable.

One-off binaries

aubx cowsay hi
aubx -p create-vite create-vite my-app

aubx is shorthand for aube dlx. It first checks for a matching local binary in the current project. If none is installed, it installs into a throwaway project and runs the requested binary. Pass -p / --package when the package name differs from the binary name or when you want to force a throwaway install.

Shortcuts: aubr and aubx

aubr and aubx are multicall shims for aube run and aube dlx. They ship side by side with aube in the release archives and dispatch purely on argv[0], so any flag that works on the full command works on the shim:

aubr build            # aube run build
aubr -r test          # aube -r run test
aubx cowsay hi        # aube dlx cowsay hi
aubx -p create-vite create-vite my-app

The shims are identical aube binaries with a different filename; there is nothing to configure. If you install aube by hand — for example by copying the binary out of the tarball — bring aubr and aubx along so the shortcuts resolve on PATH.

Workspace runs

aube -r run build
aube -F '@scope/*' run test
aube -F './packages/api' exec tsc -- --noEmit
aube -F 'api...' run build

-r is sugar for --filter=*. Filters support exact names, globs, paths, dependency/dependent graph selectors, git-ref selectors, and exclusions.