opensourceagi/dev-tools-starter-agent/server-shell-setup

Working With server-shell-setup

The shell scripts in packages/server-shell-setup (install-shell.sh, plus get-node.sh and clean-server-disk.sh). It's not an npm package — it's a bash installer you pipe from the network, aimed at a fresh VPS, container, or Termux session.

Supported systems: Arch, Ubuntu/Debian, Android (Termux), macOS, Fedora, Alpine. The script detects the OS and picks the right package manager; unsupported combinations skip the component rather than aborting the run.

Setup

On a brand-new server many providers ship with no passwords, which makes sudo fail in confusing ways. install-shell.sh checks root first: with no root password it prompts on a terminal, or in unattended runs (--yes / no TTY) sets root to the user password. Pass passwords as flags or, better (kept out of ps), env vars — root and user can share one:

SETUP_PASSWORD='...' bash install-shell.sh --components all --yes          # both accounts
bash install-shell.sh --root-password '...' --user-password '...' --yes    # separately

--root-password/SETUP_ROOT_PASSWORD always sets root; --user-password/SETUP_USER_PASSWORD sets the invoking user ($SUDO_USER under sudo) and fills root only when root has none; --password/SETUP_PASSWORD sets both. Password flags alone, with no components, just set passwords and exit.

Then pick an install mode:

wget -qO- tinyurl.com/shellsetup | bash                                   # interactive menu
wget -qO- tinyurl.com/shellsetup | bash -s -- all                         # everything, unattended
wget -qO- tinyurl.com/shellsetup | bash -s -- starship,docker,node        # specific components

The -s -- is what forwards arguments through the pipe to bash — dropping it silently gives you the interactive menu instead.

Components

Fish aliases it installs

Troubleshooting