ember
Documentation menuembr 0.13.0

Commands

embr script

Last updated November 3, 2026

embr script add <name> <command...> [--global]
embr script remove <name> [--global]
embr script edit [--global]

Edits the [scripts] table of ember.toml. With --global, it edits the global manifest, ~/.ember/tools.toml, and a script there runs in any directory. See Global scripts for how embr run finds one. These commands need embr 0.13.0 or later.

embr script add#

embr script add lint "selene src"
embr script add --global hello -- echo hello
  • Writes <name> = "<command>" under [scripts]. The words of the command are joined with spaces. Quote the command, or put it after -- when it has flags of its own.
  • A script of the same name is replaced. Its key, its comments and its spacing stay. The output says Added or Replaced.
  • The command always writes one string. For a list that runs at once, edit the file.
  • Without --global, the current directory must have an ember.toml.

embr script remove#

embr script remove lint
embr script rm --global hello

Removes one entry. The [scripts] table goes with its last entry. A name that the file does not have is an error.

embr script edit#

Opens ember.toml, or the global manifest with --global, in your editor. Ember picks the first of these that is set:

  1. $VISUAL
  2. $EDITOR
  3. the default app for the file: xdg-open on Linux, open on macOS, start on Windows

The value runs through the platform shell, so a value with flags, such as code --wait, works. An editor that exits with a code that is not 0 is an error that names the command.

The global manifest#

--global creates ~/.ember/tools.toml when it is missing. The new file starts with a comment header and nothing else:

# The global manifest of embr.
# `embr run <name>` runs a script under [scripts] here in any directory.
# A script of the same name in the ember.toml of a project wins.
# `embr tool add --global` writes the tools under [tools].

The same file holds the global tools of embr tool add --global. Ember writes only the entries that you ask for.

Each edit keeps the comments and the format of the file, but a value that you write by hand must still be TOML. A broken global manifest stops embr run and the tool shims.

See also#