memtrace install / setup / uninstall

Upgrade Memtrace, complete deferred agent setup, or clean up Memtrace integrations before removing the npm package.

Upgrade#

memtrace install|update|upgrade [--yes] [--project-only] [--no-hooks] [<command>...]

memtrace install upgrades the global npm package to the latest release. updateand upgrade are aliases. If you add another command after it, Memtrace upgrades first and then runs that command.

terminal

$ memtrace install
# upgrade to the latest release

$ memtrace install start
# upgrade, then start Memtrace

$ memtrace install index .
# upgrade, then index the current repo

USE THIS FOR UPDATE BANNERS

When Memtrace prints an update-available banner, the recovery command is simplymemtrace install. You do not need to uninstall first.

Setup#

memtrace setup [--yes] [--project-only] [--no-hooks]

memtrace setup applies or repairs the agent integrations: skills, MCP server registration, and optional hooks. Use it after a global npm install if the installer deferred those changes until you explicitly approved them.

A plain npm install -g memtrace is conservative: it installs the binary, but it will not silently edit your agent configuration without a consent signal. To finish setup afterward, run:

terminal

$ memtrace setup --yes

Uninstall#

memtrace uninstall

Run memtrace uninstall before removing the npm package. It removes Memtrace-managed agent integrations and then reminds you to remove the package itself.

terminal

$ memtrace uninstall
$ npm uninstall -g memtrace

RUN CLEANUP FIRST

npm uninstall -g memtrace removes the package, but npm does not reliably run global cleanup hooks. memtrace uninstall is the reliable cleanup step for agent config, skills, and managed integration files.

Flags#

Flag	Description
`--yes, -y`	Approve the planned integration changes without an interactive prompt.
`--project-only`	Apply setup to the current project instead of the user-level agent configuration where supported.
`--no-hooks`	Skip agent hook registration while still installing skills and MCP config.

Environment#

Variable	Default	Description
`MEMTRACE_INSTALL_YES`	—	Same effect as `--yes` for non-interactive installs.
`MEMTRACE_ASSUME_YES`	—	Alias for `MEMTRACE_INSTALL_YES=1`.
`MEMTRACE_INSTALL_PROJECT_ONLY`	—	Same effect as `--project-only`.
`MEMTRACE_INSTALL_NO_HOOKS`	—	Same effect as `--no-hooks`.
`MEMTRACE_PURGE_DATA`	—	Set to `1` during uninstall cleanup to also remove local Memtrace user data.
`MEMTRACE_UNINSTALL_PURGE_DATA`	—	Alias for `MEMTRACE_PURGE_DATA=1`.

Examples#

terminal

$ npm install -g memtrace
# installs the command

$ memtrace setup --yes
# applies agent integrations after a deferred install

$ memtrace install start
# upgrades, then starts the runtime

$ memtrace uninstall
$ npm uninstall -g memtrace
# cleans integrations, then removes the package