CLI Installation Guide

# Install globally for system-wide access
npm install -g @lovelace-ai/cli

# Verify installation
lovelace --version

# Install as dev dependency
npm install --save-dev @lovelace-ai/cli

# Run via npx
npx lovelace --version

# Or add to package.json scripts
{
  "scripts": {
    "lovelace": "lovelace"
  }
}

# Will be available via Homebrew tap
brew install lovelace-ai/tap/lovelace

npm install -g @lovelace-ai/cli

# Install Node.js if not present
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# Install CLI
npm install -g @lovelace-ai/cli

# Install Node.js
sudo dnf install npm nodejs

# Install CLI
npm install -g @lovelace-ai/cli

# Install Node.js
sudo pacman -S nodejs npm

# Install CLI
npm install -g @lovelace-ai/cli

# Install Node.js first from nodejs.org
# Then install CLI
npm install -g @lovelace-ai/cli

# Use Linux installation instructions
npm install -g @lovelace-ai/cli

# Run CLI in container
docker run --rm -it node:20 bash -c "npm install -g @lovelace-ai/cli && lovelace --help"

# For persistent usage, create alias
alias lovelace="docker run --rm -it -v $(pwd):/workspace -w /workspace node:20 bash -c 'npm install -g @lovelace-ai/cli > /dev/null 2>&1 && lovelace'"

# Verify CLI is installed
lovelace --version

# Check available commands
lovelace --help

# Run system diagnostics
lovelace doctor

# Test configuration
lovelace config show

# Test authentication (will prompt for setup)
lovelace auth status

# Run interactive setup wizard
lovelace setup

# Check authentication status
lovelace auth status

# Sign in to platform
lovelace auth signin

# Configure default workspace
lovelace workspace list
lovelace workspace switch <workspace-name>

# Update to latest version
npm update -g @lovelace-ai/cli

# Check for updates
npm outdated -g @lovelace-ai/cli

# Reset all CLI configuration
lovelace reset

# Reset specific components
lovelace config reset

# Fix npm permissions on macOS/Linux
sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}

# Or use npx instead of global install
npx @lovelace-ai/cli --version

# Check npm global bin path
npm config get prefix

# Add to PATH (add to ~/.bashrc or ~/.zshrc)
export PATH="$(npm config get prefix)/bin:$PATH"

# Check Node.js version (requires 18+)
node --version

# Update Node.js if needed
npm install -g n
n latest

# Full system check
lovelace doctor

# Check configuration
lovelace config show

# Test connectivity
lovelace auth status

# Uninstall global package
npm uninstall -g @lovelace-ai/cli

# Clean configuration (optional)
rm -rf ~/.lovelace