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
AddedorReplaced. - The command always writes one string. For a list that runs at once, edit the file.
- Without
--global, the current directory must have anember.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:
$VISUAL$EDITOR- the default app for the file:
xdg-openon Linux,openon macOS,starton 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.