Install Skytells CLI
Install the Skytells CLI on macOS, Linux, or Windows using npm. Requires Node.js 18 or later.
Requirements
- Node.js 18.0.0 or later
- npm (included with Node.js)
Check your version:
node --versionIf you need to upgrade, use nvm or download from nodejs.org.
Install
Install globally via npm:
npm install -g @skytells/cliThis makes the skytells command available system-wide.
Verify
Confirm the installation succeeded:
skytells --versionExpected output:
1.0.0View available commands:
skytells --helpPlatform notes
Install via npm as shown above. If you manage Node.js with Homebrew, ensure the global npm bin directory is in your PATH:
# Check where npm installs global binaries
npm config get prefix
# Add to ~/.zshrc or ~/.bash_profile if needed
export PATH="$(npm config get prefix)/bin:$PATH"Install via npm as shown above. If you see a permissions error, avoid using sudo with npm. Instead, configure a user-owned global directory:
# Configure npm prefix
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
# Add to ~/.profile or ~/.bashrc
export PATH=~/.npm-global/bin:$PATHThen install again:
npm install -g @skytells/cliInstall via npm as shown above. Run your terminal as Administrator if you encounter permissions errors, or configure a user-owned prefix.
Verify that %APPDATA%\npm (or your configured npm prefix) is in your system PATH.
# Verify installation
skytells --versionUpdate
Update to the latest version at any time:
npm update -g @skytells/cliCheck the installed version:
skytells --versionUninstall
npm uninstall -g @skytells/cliThis does not remove stored credentials. To remove credentials:
rm -rf ~/.config/skytellsNext step
Once installed, authenticate with your Skytells account:
skytells loginSee Authentication for all login methods and token configuration.
How is this guide?
Get Started
The Skytells CLI lets you manage your entire Skytells environment from the terminal — deploy apps, provision databases, stream logs, monitor infrastructure, and automate workflows without opening a browser.
Auth
Sign in to Skytells, manage personal access tokens, configure project access keys, and control credential storage.