๐ GTM Engineer Onboarding: Windows/WSL Edition
๐ Phase 0: Terminal Configuration (Windows Terminal)
To avoid โWindows Syntax Hell,โ you must configure Windows Terminal to launch into Linux by default.
Instructions:
- Open Windows Terminal.
- Press
Ctrl + ,to open Settings. - Under Startup, set Default profile to
Ubuntu. - Under Profiles (Ubuntu) > Starting directory, uncheck โUse parent process directoryโ and set it to
~or\\wsl$\Ubuntu\home\yourusername. - Save and restart the terminal. You should now see a
$prompt instead of aPS >prompt.
Welcome to the WayCup Engine, Brenn. This guide will synchronize your Windows/WSL2 environment with the WayCup Thin-Client Infrastructure (TCI), allowing you to jump straight into Go-To-Market (GTM) Engineering.
๐ ๏ธ Phase 1: Environment Diagnostics
Before making any changes, we must verify that your WSL foundation is healthy.
Instructions:
Open your WSL (Ubuntu) terminal and run these commands one by one.
# 1. Verify 1Password CLI is installed and authenticated
op whoami
# 2. Verify Node is ready for the Gemini & HubSpot CLIs
node -v && npm -v
# 3. Verify Tailscale is active on the WayCup network
tailscale status | head -n 3
# 4. Verify you are in the Linux filesystem (Should NOT start with /mnt/c/)
pwdโ Testing & Verification
- Expected Result:
op whoamireturns your WayCup email. Node is v20 or v22. Tailscale shows you on the WayCup tailnet.pwdreturns/home/brennwc(or similar). - โ Remediation:
opcommand not found: Runsudo apt install 1password-cliand sign in.- Tailscale not running: Run
sudo tailscaled --tun=userspace-networking --socks5-server=localhost:1055 &thentailscale up. - Wrong Directory: Run
cd ~to return to your Linux home. Never run TCI tools from/mnt/c/.
๐ Phase 2: Dotfiles & Core Aliases
Because you maintain a fork of Kevinโs dotfiles, we do not want to run global sync scripts that overwrite your personal terminal UI. Instead, we use a shared โGistโ for core WayCup commands.
Instructions:
- Open your local aliases file:
nano ~/.bash_aliases- Paste this line at the very bottom (Kevin will provide the actual Gist URL):
# WayCup Core Aliases (Cloud Synced)
source <(curl -s https://gist.githubusercontent.com/kevindockman/4f135243cf94c7fcd13925a5a31926a4/raw/waycup_core_aliases.sh)- Save and reload:
source ~/.bashrcโ Testing & Verification
- Expected Result: Run
cdway. It should instantly transport you to the01_internal/core/vaultdirectory. - โ Remediation: If it fails, ensure
curlis installed (sudo apt install curl) and verify the Gist URL with Kevin.
๐ป Phase 3: Antigravity IDE via Windows
You will run the Windows Native version of Antigravity for optimal UI performance, but trigger it from inside WSL.
Instructions:
Add this alias to your ~/.bash_aliases (adjust the path if your Windows username differs):
# Map 'antigravity' in WSL to the Windows executable
alias antigravity='/mnt/c/Users/Brenn/AppData/Local/Programs/Antigravity/Antigravity.exe'โ Testing & Verification
- Expected Result: Run
antigravity .in yourcore/vaultdirectory. The Windows UI should open seamlessly, editing the Linux files. - โ Remediation: Check the exact path to your
Antigravity.exein Windows Explorer and update the alias.
๐ค Phase 4: AI & GTM Tooling
Install the core CLI tools required for WayCup development.
Instructions:
# Install Gemini CLI globally
sudo npm install -g @google/gemini-cli
# Install HubSpot CLI globally
sudo npm install -g @hubspot/cli
# Index your local vault to power the AI Brain
cd ~/projects/01_internal/core/vault
gemini /obsidian:indexโ Testing & Verification
- Expected Result: The Gemini CLI should successfully index your markdown files.
- โ Remediation: If Gemini fails to index, ensure your
~/.gemini/settings.jsonand.envare configured correctly per your original bootstrap guide.