Registry / devops / vaco-machine-setup

vaco-machine-setup

library1.0.3jsnpmunverified

Full machine setup & migration tool that backs up credentials, AI agent state, tool configs, and agent skills from one machine and restores them on a new machine. Version 1.0.3, requires Node >=18. Differentiators: covers 21+ agent skills (Claude Code, Hermes, OpenCode), preserves file permissions (SSH keys → 600), supports offline tarball install, and bundles an install command for system deps, CLI tools, dev runtimes, and AI agents. Backup output ~1-5 MB. Useful for developers migrating workstations with complex AI toolchains. No updates since initial release; check GitHub for status.

devops

npm install vaco-machine-setup

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · VACO-MACHINE-SETUP

vaco-machine-setup

devopsjavascriptv1.0.3

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default (CLI)

✓ npx vaco-setup --help

The package is a CLI tool; primary usage is via `npx vaco-setup` or global install `npm install -g vaco-machine-setup` and then `vaco-setup`.

programmatic API

✓ import { backup, install, restore } from 'vaco-machine-setup'

The package may export programmatic functions for integration. Assuming ESM exports; check documentation for exact symbols.

CommonJS require

✓ const { backup, install, restore } = require('vaco-machine-setup')

CommonJS require may be available; verify package.json exports.

Shows the full backup/install/restore workflow using npx commands.

// Backup current machine npx vaco-machine-setup backup --output ./my-backup.tar.gz // Copy backup to new machine (e.g., scp user@new-machine:~/) then: // Install tools on new machine npx vaco-machine-setup install --with-skills // Restore configs from backup npx vaco-machine-setup restore ./my-backup.tar.gz --force // Or all-in-one npx vaco-machine-setup full ./my-backup.tar.gz --with-skills --force

Debug

Known issues

gotchavaco-setup install requires sudo for system packages (curl, git, docker, tmux, zsh). Non-sudo users will fail.

fix

Run with sudo or pre-install system dependencies manually.

affects: >=1.0.0

gotchaThe backup command collects credentials (SSH keys, Docker auth, npmrc, Claude auth). If the backup file is compromised, all credentials are exposed.

fix

Encrypt the backup tar.gz before transfer (e.g., gpg -c my-backup.tar.gz).

affects: >=1.0.0

deprecatedInstallation of CLI tools (neovim, starship, etc.) may install outdated versions because the tool fetches from system package managers or hardcoded URLs.

fix

After running vaco-setup install, update tools manually (e.g., brew upgrade neovim, starship upgrade).

affects: >=1.0.0

gotchaThe restore command with --force overwrites existing config files without backup.

fix

Back up existing configs manually before running restore, or use restore without --force to see what would be overwritten (if interactive mode exists).

affects: >=1.0.0

gotchaNode version must be >=18. Running with older Node versions will fail with syntax errors or missing APIs.

fix

Upgrade Node to v18 or later (e.g., using nvm install 18).

affects: >=1.0.0

Errors

Common errors & fixes

command not found: vaco-setup

Package not installed globally or npx not available.

fix

Run `npx vaco-machine-setup` instead, or install globally with `npm install -g vaco-machine-setup`.

Error: EACCES: permission denied, open '/usr/local/lib/node_modules/vaco-machine-setup/...'

Global npm install failed due to insufficient permissions.

fix

Use `sudo npm install -g vaco-machine-setup` or configure npm prefix per https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally

Error: Cannot find module 'vaco-machine-setup'

Programmatic import but package not installed locally.

fix

Run `npm install vaco-machine-setup` in your project directory.

Error: spawn sudo ENOENT

The `install` command requires sudo but it's not installed on the system (e.g., Docker container, Windows).

fix

Pre-install system dependencies manually or run in an environment where sudo is available.

Upgrade

Version history

1.0.3latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

6 hits · last 30 days

node

Resources

githubhttps://github.com/prasenjitjana/vaco-machine-setup ↗

packagevaco-machine-setup ↗

homepagehttps://github.com/prasenjitjana/vaco-machine-setup#readme ↗