ember
Documentation menuembr 0.13.0

Commands

embr search

Last updated November 2, 2026

embr search <query> [--environment <env>] [--language <language>] [--limit <n>]
embr search <query> --all [--limit <n>]

Finds packages by name or description. It only reads, and it works outside a project too.

Output#

The first line counts the matches. Each line after it is one package. This is embr search chief --limit 3:

3 of 6 matching packages, most downloaded first:
chief/core 0.2.0 roblox | 226 downloads | The core of Chief, a strictly and fully typed Luau module framework for Roblox. | install: embr add chief/core
chief/bin 0.2.0 roblox | 122 downloads | A small, strictly typed cleanup container for Roblox: connections, instances, threads, and functions, emptied in reverse insertion order. | install: embr add chief/bin
chief/lifecycles 0.3.0 roblox | 118 downloads | The Lifecycles extension for Chief: binds events to module methods. | install: embr add chief/lifecycles

A line gives the name, the latest version, the environments, the download count, the description, and the embr add command. It also gives the language when it is not Luau, and a deprecation reason. The results are the same as those of the embr mcp search tools.

Behavior#

  • The registry matches each word of the query to the start of a word in a name or a description. A package must match every word, and case does not matter. The most downloaded packages come first.
  • --environment and --language keep only the packages for that environment or in that language, as in embr init. luau is portable Luau.
  • --limit sets the number of packages: 20 by default, and 50 at most.
  • --all also searches Wally, pesde, and Forest, at the same time. Each registry gives its packages in its own order, and --limit is for each registry, 10 by default. Wally, pesde, and Forest need a query of 2 or more characters. A registry that fails, or gives no answer in 10 seconds, is listed at the end with the reason. The other registries still answer.
  • --all cannot take --environment or --language, because only the Ember registry filters by them.
  • The embr add command of a Wally, pesde, or Forest package has --index. Run embr index add <name> once in the project first.
  • Forest copies each open-source Wally package. The results leave out those copies.
  • Private and unlisted packages never show in search.
  • EMBER_API_URL points the search at another registry API, such as a local backend.

Examples#

embr search signal                          # the Ember registry
embr search ecs --language alloy
embr search a --environment roblox --limit 5
embr search signal --all                    # also Wally, pesde, and Forest

See also#

  • embr info for the versions and dependencies of one package.
  • embr add to add what you find.