I lost my recovery phrase#

If any device is still signed in and unlocked (the CLI or a browser), you keep working; create a new phrase in Settings, Recovery, or with the web app's recover page. If you lost the phrase and every device, your encrypted data can't be recovered: start over with a new identity (web app, Unlock, "Start over with a new key") and ask teammates to share their projects with you again. Secrets only you could read are lost.

I have a new laptop#

Or choose "enter recovery phrase" when login asks, or approve the device in the web app while it is unlocked.

$ storeenv login
# then, on a device you already use:
$ storeenv device approve <code> --device-key <key>

"Not shared with you" or pending key share#

You are allowed in but nobody has wrapped the keys for you yet. Give a teammate who can read the secrets your fingerprint (storeenv whoami) so they can run storeenv verify @you <fingerprint>; their next command, or storeenv share, gives you the keys. If pull says some keys aren't shared with you, your grant doesn't cover them: storeenv request asks for more.

storeenv: command not found after npm i -g#

npm put the command in its global bin folder, which isn't on your PATH:

$ npm prefix -g
# the command is in <prefix>/bin (Windows: <prefix>)
$ export PATH="$(npm prefix -g)/bin:$PATH"   # add this to ~/.zshrc or ~/.bashrc

• If your npm prefix is ~/.local, the command is in ~/.local/bin: add that to PATH.
• The shell installer puts the binary in ~/.storeenv/bin and adds it to your shell profile; open a new terminal, or run export PATH="$HOME/.storeenv/bin:$PATH".
• Run hash -r (bash) or rehash (zsh) after installing in an open shell.

Homebrew on an Intel Mac or under Rosetta#

The formula has native Apple silicon and Intel builds and picks the one matching your Homebrew: /opt/homebrew is Apple silicon, /usr/local is Intel (including Intel Homebrew under Rosetta). If brew reports the wrong architecture, run brew config to see which Homebrew you're using, and make sure storeenv comes from the same one (which storeenv).

The confirmation or invitation email doesn't arrive#

• Look in spam and in all mail, and search for StoreEnv.
• Links work for 30 minutes (signup, password reset) or 14 days (invitations). Ask for a new one if it expired.
• If signup says "We couldn't send the email", wait a few minutes and try again; if it keeps failing, write to hello@storeenv.app.
• An invitation by StoreEnv username also shows in the web app under Invitations, even without the email.

Something else#

storeenv doctor checks your setup and says what to fix. Every error has a code; the error catalogue explains each one.