ponshu-room-lite/docs/architecture/VSCODE_SSH_SETUP_GUIDE.md

VS Code Remote SSH Setup Guide

1. Install the Extension

1. Open VS Code on your local PC.
2. Go to the Extensions view (Square icon on the left).
3. Search for "Remote - SSH" (by Microsoft).
4. Click Install.

2. Configure the Connection

1. Press F1 (or Ctrl+Shift+P) to open the Command Palette.
2. Type "Remote-SSH: Open SSH Configuration File".
3. Select the first option (usually C:\Users\...\.ssh\config).
4. Add the following entry (replace with actual values):

Host posimai-fortress
    HostName 100.x.y.z       # Tailscale IP of the Ubuntu VM
    User ubuntu              # Username on the VM
    # IdentityFile ~/.ssh/id_rsa  # Path to your private key (if used)

Tip: Using the Tailscale IP (100.x...) is recommended as it works from anywhere (home or office).

3. Connect!

1. Click the green "><" icon at the very bottom-left corner of VS Code.
2. Select "Connect to Host...".
3. Select posimai-fortress.
4. A new VS Code window will open. It might ask for a password (if you haven't set up keys).
5. Once connected, click "Open Folder" and navigate to /home/ubuntu/dev/posimai/.

4. Verify

• Open the Terminal in VS Code (Ctrl+J).
• Type hostname. It should say ubuntu (or whatever you named the VM), NOT your local PC name.
• Success! You are now inside the Fortress. All code stays there.

---

Next Step: Once connected, open a New Cursor Chat and paste the CURSOR_CHAT_MASTER_CONTEXT.md prompt.