Why doesn't Auralogger pick up my env values?

Run the CLI from the directory that contains your .env or .env.local. Auralogger loads env from process.cwd() — not from a global location.

Which env keys do I need to set?

At minimum AURALOGGER_PROJECT_TOKEN. Encrypted projects also need AURALOGGER_USER_SECRET (server only). Browser bundles use NEXT_PUBLIC_AURALOGGER_PROJECT_TOKEN or VITE_AURALOGGER_PROJECT_TOKEN.

How do I import Auralogger in browser code?

Import from auralogger-cli/client to avoid server-only modules like ws, fs, and process being bundled into the browser.

Why are my get-logs filters failing?

Filter values must be valid JSON on the command line. Use arrays even for single values, e.g. -type '["error"]'.

Auralogger troubleshooting — env, imports, get-logs filters

Fix wrong cwd, missing AURALOGGER_PROJECT_TOKEN or AURALOGGER_USER_SECRET, server-only code in browser bundles (use auralogger-cli/client), and invalid JSON in get-logs filters.

Troubleshooting checklist
- Run CLI from folder containing .env / .env.local.
- Get values from /projects -> your project -> Setup guide.
- Confirm AURALOGGER_PROJECT_TOKEN is set.
- For encrypted mode, confirm AURALOGGER_USER_SECRET is set server-side.
- In browser code, import from auralogger-cli/client and avoid server-only deps.
- For get-logs filters, pass valid JSON values on the command line.

Common fixes
- Wrong cwd:
  - move to app directory before running init/check/get-logs.
- Missing credentials:
  - run init or set token/secret/session explicitly.
- Browser bundling failures:
  - switch imports away from server entrypoints.
- Filter parsing failures:
  - use array syntax such as -type '["error"]' even for one value.

Troubleshooting

Most issues are environment loading (wrong directory), missing credentials, or importing server-only code into a browser bundle.

Get env values from the project setup guide:

Go to Projects (/projects).
Click your project.
Click the Setup guide button.
Copy the env keys from the guide.

Checklist

1- Run CLI from the folder that contains .env / .env.local
2- Get env values: /projects → your project → Setup guide → copy env keys
3- Confirm AURALOGGER_PROJECT_TOKEN is set
4- For encrypted mode, confirm AURALOGGER_USER_SECRET is set (server only)
5- If filters fail: values must be valid JSON on the command line