@sigaostudios/bootstrap

🚀 One-command bootstrap for Sigao AI DevKit on fresh systems

This package handles all the prerequisites and authentication needed to run the Sigao CLI on a fresh Linux/WSL system.

What it does

1. ✅ Installs Node.js (if not present)
2. ✅ Installs GitHub CLI (if not present)
3. ✅ Authenticates with GitHub (with read:packages scope)
4. ✅ Configures npm to access @sigaostudios packages
5. ✅ Launches the Sigao CLI installer

Usage

On a fresh WSL/Linux system, just run:

npx @sigaostudios/bootstrap

⚠️ WSL Users with PATH Issues

If you see "CMD.EXE was started" or "apt-get is not recognized", you have Windows npm in your PATH. Use this instead:

# First ensure Linux npm is installed
sudo apt update && sudo apt install -y npm

# Then run with Linux npx explicitly
/usr/bin/npx @sigaostudios/bootstrap

That's it! No need to worry about tokens, authentication, or prerequisites.

Requirements

• Linux or WSL (Windows Subsystem for Linux)
• sudo access (for installing system packages)
• Internet connection

What happens during bootstrap

1. Prerequisites Check: The bootstrap will check for Node.js and GitHub CLI, installing them if needed.

2. GitHub Authentication: You'll be prompted to authenticate with GitHub (if not already authenticated). This is done through the GitHub CLI's interactive auth flow.

3. npm Configuration: The bootstrap automatically configures npm to access the private @sigaostudios packages using your GitHub token.

4. Sigao CLI Launch: Finally, it launches the main Sigao CLI installer.

For WSL Users

Make sure you're running this inside WSL, not in Windows Command Prompt or PowerShell.

Common Issue: If Windows paths are in your PATH before Linux paths (often from fnm, nvm-windows, or other Windows Node managers), you'll need to use /usr/bin/npx instead of just npx to ensure Linux tools are used.

Troubleshooting

If you encounter issues:

1. sudo password: You'll need to enter your sudo password to install system packages
2. GitHub auth: Make sure to complete the GitHub authentication flow when prompted
3. Network issues: Ensure you have a stable internet connection

Development

This package is part of the Sigao AI DevKit monorepo.

License

MIT