Changelog

A curated record of changes across Pear and its modules, newest first. Entries are grouped by module, and every Breaking item links to migration guidance. For the raw upstream record, see each module's GitHub releases; this page is the docs-team view of what the changes mean for your application.

2026-07 — Pear v3

Pear v3 completes the split announced in Pear Evolution: the runtime moves out of the CLI and into the embeddable Pear OTA (pear-runtime) library, and the CLI focuses on deployment and installation.

pear (CLI) — v3

• Breaking: pear run removed. Launch applications by embedding Pear OTA instead—see Migrate from pear run to Pear OTA. Running it now exits with pear run has been removed.
• Breaking: pear release removed. The single-key release pointer is replaced by quorum cosigning—use pear provision + pear multisig.
• Breaking: pear presets, pear shift, and pear drop removed. For resetting an app's storage, see Manage installed applications.
• Breaking: the ambient global.Pear API is gone with pear run. The Pear API page is retained for reference only.
• Breaking: --no-ask (all commands), pear stage --compact, and pear sidecar --mem/--key flags removed; pear data slims down to dht and multisig subcommands.
• Added: pear install <link> installs applications from peers directly into the OS application folder (provided by pear-install).
• Added: pear multisig keys paths, pear info --multisig, pear sidecar shutdown|inspect, and pear gc cores [link].
• Changed: pear build is now provided by the standalone pear-build module.

pear-runtime (Pear OTA) — v1.3.1

• The embeddable OTA-update library is now branded Pear OTA in these docs; the package name stays pear-runtime.
• Constructor accepts store + swarm (supply your own Corestore/Hyperswarm, together), storage, delay, and bundled options—see the Options reference.
• PearRuntime.run() workers started from a Bare process run as Bare threads; thread workers do not expose IPC.stdin/stdout/stderr.

See also

• Pear CLI reference—current command set with removed commands badged.
• Migrate from pear run to Pear OTA—the v3 migration path.