2.7 KiB
Installation and setup
REA separates installing its CLI from configuring external software and coding agents.
Install the CLI
The recommended installation is:
npm install --global rea-agents
rea setup
REA supports Node.js 22.19+ and 24.11+ (including newer releases). It uses the npm already paired with that runtime and never upgrades Node.js, npm, or Homebrew.
The optional curl wrapper installs only the global npm package:
curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash
It prints the version, runtime, npm command, and destination before installing. When a controlling terminal exists it starts rea setup; otherwise it prints the command to run later.
Pass options with bash -s --:
curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh |
bash -s -- --dry-run
Supported options are --version <semver>, --dry-run, --no-setup, --no-prompt, and --verbose. Neither --no-prompt nor a non-interactive shell grants permission to install external dependencies.
Review setup changes
rea setup discovers the current state, prints one plan, and asks Continue? [Y/n]. The plan identifies:
- an existing Hopper installation or the official package it proposes to install;
- each detected coding-agent configuration path;
- the REA skill destination;
- external software and package-manager effects.
Declining makes no changes. Agent configuration writes preserve unrelated entries, create backups, use atomic replacement, and verify their result.
For automation, rea setup --json reports the plan without applying it. rea setup --yes applies user-owned registrations and the skill. Installing missing Hopper non-interactively additionally requires --install-hopper:
rea setup --yes --install-hopper --json
Hopper
Hopper is separate commercial software with its own license. REA reuses any detected installation and preserves Hopper during uninstall.
On macOS, approved setup downloads the official DMG, checks its published size and digest, validates the application bundle, and atomically installs it to ~/Applications/Hopper Disassembler.app. REA then opens Hopper for its one-time activation. Homebrew and administrator access are not used.
On supported Linux distributions, approved setup verifies Hopper's official .deb, .rpm, or Arch package before invoking the native package manager. Unattended package-manager access requires --yes --install-hopper.
Diagnose, update, and remove
rea doctor --json is strictly read-only. rea upgrade updates only the npm installation that owns the running CLI. rea uninstall removes only REA-owned agent registrations and skill files; --purge-data additionally removes REA cache and state paths.