Install Pear and Pear Applications

CLI

The published binary. With no link, installs the Pear platform. With a pear:// link, installs that application and/or its binaries.

npx pear-install [link]

Flags

• --to <dir> — target directory (overrides platform default)
• --only <paths> — comma-separated filenames to install
• --timeout <seconds> — network timeout (default 30)
• --dht-bootstrap <nodes> — comma-separated host:port
• --json — newline-delimited JSON output (one { cmd: 'install', tag, data } per line)

Default install destinations

• macOS — apps to /Applications, bins to ~/.local/bin
• Linux — apps to ~/Applications, ~/AppImages, or ~/.local/bin; bins to ~/.local/bin
• Windows — apps installed as MSIX packages; bins (.exe) to %LOCALAPPDATA%\Programs\<app>\ with the install directory added to the User PATH

API

const Install = require('pear-install')

const install = new Install(opts)

• link (string) — pear:// link
• to (string, optional) — target directory
• only (string, optional) — comma-separated filenames
• bootstrap (array, optional) — [{ host, port }, ...] DHT nodes
• timeout (number, optional) — milliseconds, default 30000
• corestore (Corestore, optional) — inject an existing corestore; not closed by install.close()
• swarm (Hyperswarm, optional) — inject an existing swarm; not destroyed by install.close()

If corestore or swarm is omitted, Install creates and owns its own.

await install.ready()

Runs the install. Throws on failure.

await install.close()

Releases the drive, the owned swarm and corestore, and removes the temp dir.

Reusing a corestore and swarm

const corestore = new Corestore('./store')
const swarm = new Hyperswarm()
swarm.on('connection', (c) => corestore.replicate(c))

for (const link of links) {
  const install = new Install({ link, corestore, swarm })
  await install.ready()
  await install.close()
}

await swarm.destroy()
await corestore.close()

Events

• installing → { link, host }
• app → { app, name, version, upgrade, verlink, key, dest }
• stats → { download, upload, peers }
• path → { dir } — Windows only; emitted when a bin directory is appended to the User PATH
• final → { success, installed, exists }

Web Bootstrap Shell Scripts

The pear.sh and pear.ps1 files install the pear binary over HTTPS with zero external dependencies. Each fetches checksums.sha256, downloads the binary for the detected OS/arch, verifies its SHA-256 before moving it into place, and adds the install directory to PATH.

On macOS and Linux (installs to ~/.local/bin):

curl https://install.pears.com/pear.sh | sh

On Windows, PowerShell (installs to %LOCALAPPDATA%\Programs\pear\):

irm https://install.pears.com/pear.ps1 | iex

Both scripts double as boilerplate for other projects. To reuse:

• set base to the domain you'll host from
• set name to your binary's name
• rename the file to match (<name>.sh / <name>.ps1)

Host the per-OS/arch binaries and checksums.sha256 under <domain>/<name>/, mirroring the paths the script requests (e.g. <domain>/<name>/darwin-arm64/app/<name>).

Command Integration: /cmd

For embedding in another CLI. Wraps Install as a pear-opstream of { tag, data } records with stdout formatters.

const InstallCmd = require('pear-install/cmd')

const stream = new InstallCmd({ link, to, only, bootstrap, timeout })
await InstallCmd.output(json, stream)

Tags

• installing → { link, host }
• app → { app, name, version, upgrade, verlink, key, dest }
• stats → { download, upload, peers }
• path → { dir } — Windows only
• error → { code, message, stack, info, success: false }
• final → { success, installed, exists }

await InstallCmd.output(json, stream)

Drains stream to STDOUT.

• json truthy — emits each record as { cmd: 'install', tag, data }, newline-delimited.
• json falsy — formats per-tag; stats updates in place via ANSI; static tags stack above.

Returns the final record.

await InstallCmd.runner(cmd)

Pass directly as a paparam command runner. Creates InstallCmd instance and passes it to InstallCmd.output

• cmd is a paparam cmd instance

License

Apache-2.0