@focus.matters/upm
v0.2.7
Published
Install and update declared agent resources from npm packages.
Readme
@focus.matters/upm
Utility package manager for agent resources published by npm packages.
Usage
upm init
upm install
upm install @focus.matters/console-monitor
upm updateupm init writes upm.json in the current directory. All other commands require that file.
upm install lets you select one of the known util packages generated at build time from packages under utils that declare util-package. upm install <package> reads the package metadata from npm first. It downloads the package tarball only when selected resources need package files, such as commands, skills, or manuals. MCP-only installs can be written directly to config.toml.
Commands are installed into .upm/bin under the current project. Add that directory to PATH when you want to invoke installed commands directly.
Packages that install commands can include post-install.mjs or post-install.js at the package root. When present, upm runs it after installing selected command resources.
Paths in upm.json are portable. ~, %USERPROFILE%, %HOME%,
$USERPROFILE, and $HOME are expanded when resources are installed, while
relative paths are resolved from the workspace containing upm.json.
