Install

Install @merekit/cli when you want the public mere command, bundled app adapters, docs, and the repo-local mere-cli skill.

Requirements

• Node.js >=24 <26.
• npm or pnpm.
• Mere workspace access for workspace-scoped product reads.
• App auth where the target product requires it.

Install From npm

For a zero-friction first run, use the package through npx:

npx --yes @merekit/cli@latest --help
npx --yes @merekit/cli@latest onboard --interactive

For a stricter one-shot run, disable dependency lifecycle scripts:

npx --yes --ignore-scripts @merekit/cli@latest --help

Install globally when you want a persistent mere command:

npm install -g @merekit/cli
mere --help

The published CLI does not require install scripts, so hardened global installs can use npm install -g --ignore-scripts @merekit/cli.

On stock macOS npm, global installs may fail with EACCES under /usr/local/lib/node_modules. Use npx, use pnpm, or configure npm to install globals into a user-owned prefix:

npm config set prefix ~/.local
mkdir -p ~/.local/bin
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
npm install -g @merekit/cli
mere --help

With pnpm:

pnpm add -g @merekit/cli
mere --help

Confirm the installed package can resolve app adapters:

mere apps list --json
mere ops doctor --json

Installed users should normally see app CLI entries with source: "bundled".

Use This Repository

For development inside this repo:

pnpm install
pnpm build
node dist/run.js --help
node dist/run.js help onboard

The npm package ships compiled runtime files under dist/ and bundled app adapters under adapters/. Public contributors do not need to rebuild app adapters for normal root CLI development.

App CLI Resolution

When mere delegates to an app CLI, it resolves the adapter in this order:

1. Explicit environment override, such as MERE_PROJECTS_CLI=/path/to/run.js.
2. Bundled adapter inside @merekit/cli/adapters/.
3. Local Mere repository paths under MERE_ROOT.
4. App binaries on PATH, such as mere-projects, mere-zone, or merefi.

Use MERE_CLI_SOURCE=auto|bundled|local|path to force a source while debugging install behavior.

The media adapter is resolved the same way, but local media processing has extra runtime dependencies: mere media process ... --transcribe --embed calls the public mere.run executable and needs local ASR/embedding models. Run mere setup mere-run --json to orchestrate the runtime install, then mere setup mere-run models --app media --json to pull app-requested models. In a local Mere checkout, it builds from ~/mere/run-public; installed users can download https://mere.run/releases/mere-run.dmg by providing a verified checksum with MERE_MEDIA_MERE_RUN_DOWNLOAD_SHA256 or --sha256.

Check The Command Plane

mere --help
mere help onboard
mere apps list --json
mere ops doctor --json

If those work, continue to First Run.