CLI overview

Global behavior#

• Every successful command ends with a dimmed Done in 142ms timer.
• Errors print as ✗ message and exit 1; CLI usage errors exit 2.
• embr i is an alias for embr install, and embr x for embr execute.
• Tool runs through shims (typing rojo in a project) don't print the timer.
• Every script Ember runs is announced first, in npm's dimmed two-line form (> acme/rocket@0.1.0 build, then the command line). See embr run.

Commands#

Command	What it does
embr init	interactive manifest wizard
embr add	record a dependency, resolving before editing
embr install	install dependencies and tools, write ember.lock
embr outdated	list the dependencies with a newer release; installs nothing
embr patch	edit a dependency's source and keep the edit
embr publish	pack, authenticate, upload to the registry, or --local
embr auth	login, logout, whoami, token for the GitHub login
embr yank	keep a version out of new installs, or --undo it
embr deprecate	mark a package or one version as deprecated, with a reason
embr mcp	serve package search to a coding agent over MCP
embr index	manage named indices (wally, pesde, forest, custom); local needs no entry
embr cache	clear the archive and index caches
embr tool	pin GitHub-released binaries
embr execute	run a released tool without installing it (alias x, or the embx binary)
embr run	run a [scripts] entry, or list them all
embr build test start serve dev fmt	the six scripts that can drop run, also as build:prod
embr studio	describe and open the project in Roblox Studio
embr self	install, update, uninstall, editor IntelliSense, default-index

The six script subcommands are real commands, not a fallback for unrecognized input, so a [scripts] entry can never shadow or replace an Ember command. A name that starts with one of them and a colon, such as embr build:prod or embr dev:gameplay, runs that script without run. Every other script needs embr run.

Exit codes#

Code	Meaning
0	success
1	runtime error
2	CLI usage error