totatota/docs
On this page

tota requires Node.js 20+. Install with npm:

npm i -g tota-agent

Or pin to the latest release:

npm i -g tota-agent@0.0.3

Or run without installing:

npx tota-agent

#Upgrade

tota includes a built-in upgrade command that handles the full update cycle:

tota upgrade

This command:

  • Checks npm for the latest published version
  • Stops the daemon if running, to avoid conflicts
  • Removes the old package first to prevent ENOTEMPTY errors
  • Installs the latest version globally
  • Shows the before/after version comparison
ℹ️

ENOTEMPTY fix — If you see ENOTEMPTY: directory not empty, rename when running npm i -g manually, use tota upgrade instead — it removes the old package directory before installing the new one.

⚠️

Windows EEXIST fix — If you see EEXIST: file already exists for the tota binary (common when upgrading from an older package name), delete the orphaned shim first:

Remove-Item "$env:APPDATA\npm\tota","$env:APPDATA\npm\tota.cmd","$env:APPDATA\npm\tota.ps1" -Force -ErrorAction SilentlyContinue
npm i -g tota-agent
PreviousIntroductionNextFirst-Time Setup