Reference
Files & locations
Last updated October 23, 2026
In the project#
| Path | What it is |
|---|---|
ember.toml | the manifest |
ember.lock | the lockfile (commit it) |
packages/<env>/ | a self-contained environment root — everything a tree declared for that environment needs, whatever realm each package is (configurable via [config], gitignored by init) |
packages/<env>/.ember/.state | stamp of what the last install produced; backs the fast path |
.ember-staging/ | transient dir during installs, removed afterwards even on failure |
.ember-patch/ | embr patch working copies; scratch space, gitignored by init |
patches/ | committed patch files, referenced from [patches] in ember.toml (commit them) |
In your home directory#
| Path | What it is |
|---|---|
~/.ember/bin/ | embr, embx, and tool shims; must be on PATH |
~/.ember/tools/ | downloaded tool binaries, {owner}_{repo}/{version}/; also serves embx runs, cleared by embr tool cache clean |
~/.ember/tools.toml | global tool pins |
~/.ember/credentials.toml | the GitHub login from embr auth login or embr publish (0600 on unix) |
~/.ember/config.toml | settings for every project, such as the index embr self default-index sets |
~/.ember/local/ | the local registry: index/ holds the entries, archives/ the packages |
~/.ember/index-cache/ | shallow git clones of every index used |
~/.ember/index-cache/<name>/.ember-refreshed | per-index freshness stamp backing the 5-minute TTL |
~/.ember/archive-cache/v1/ | downloaded package archives + .meta integrity sidecars; unbounded, cleared by embr cache clean |
Environment variables#
| Variable | Effect |
|---|---|
EMBER_INDEX_TTL_SECS | how long an index check — and embx's latest-release check — stays fresh. Default 300; 0 means ask every time; malformed values warn and use the default |
EMBER_TIMINGS=1 | prints per-phase timing lines to stderr |
Exit codes#
| Code | Meaning |
|---|---|
| 0 | success |
| 1 | runtime error |
| 2 | CLI usage error |