Brainforge Knowledge

fresh-install-setup

2 min read

Fresh Install Setup (Platform, Playbook, and Vault)

Use this when you are setting up a new machine and want to use the Brainforge platform, playbook, and vault. The setup script installs the tools you need so you can clone the repo, run the platform app, and follow playbook workflows (including 1Password for credentials).

What the script installs

ToolWhy
GitClone and work with the repo (platform, playbook, and vault live here).
Node.js LTSRun the platform app.
1Password CLI (op)Vault and playbook workflows use 1Password for credentials; Cursor rules expect op.
GitHub CLI (gh)Open PRs when contributing to playbook or vault.

The script skips anything already installed. It does not install Cursor (install Cursor first), and it does not sign you in to any service (you do that in the “Next steps” below).

How to run the script

Windows

  1. Open PowerShell (search for “PowerShell” in the Start menu).
  2. Go to the folder that contains the script (or download/clone the repo first and cd to standards/05-scripts/setup).
  3. Run: 
    powershell -ExecutionPolicy Bypass -File setup.ps1
  4. If you get “winget is not installed”, install winget from: Microsoft: Install winget.

macOS

  1. Install Homebrew if you don’t have it: https://brew.sh
  2. Install PowerShell (so you can run the same script): 
    brew install pwsh
  3. Go to the folder that contains the script (e.g. after cloning the repo: cd standards/05-scripts/setup).
  4. Run: 
    pwsh ./setup.ps1

After the script: next steps

Do these so you can actually use the platform, playbook, and vault:

  1. Sign in to 1Password CLI
    Run: op signin
    Guide: 1password-cli-setup.md

  2. Log in to GitHub CLI (for PRs when contributing)
    Run: gh auth login
    Guide: github-cli-setup.md

  3. Set up an SSH key (for cloning the repo)
    Guide: ssh-key-setup.md

  4. Clone the repo and open it in Cursor to use the platform, playbook, and vault.

Optional: To connect Linear or GitHub MCP in Cursor, see setup-connect-linear-to-cursor.md.

Where the script lives

  • Script: standards/05-scripts/setup/setup.ps1
  • This guide: standards/01-onboarding/fresh-install-setup.md

Graph View