AI Assist – Progressive Setup Workflow

Phase 1 · The Prerequisites (Ground Work)

Install VS Code, Git, and Configure SSH Keys

Complete the three mini-steps below to set up your development environment. Once finished, you'll have VS Code installed, Git configured, and SSH keys ready for secure access to Deloitte repositories.

You will: Install VS Code (Editor setup) → Install Git (Requires Deloitte-US GitHub access) → Configure SSH Keys (Full setup instructions)

VS Code Installation

Go to Official Website and click the blue Windows download button.
Open File Explorer → Downloads, then double-click the file that starts with VSCodeUserSetup.
If Windows SmartScreen appears, click More info → Run anyway.
Accept the license agreement and keep the default installation folder.
On the Select Additional Tasks screen, check both “Add ‘Open with Code’” options and “Add to PATH” so VS Code is available in the right-click menu and terminal.
Click Install. When finished, leave “Launch Visual Studio Code” checked and click Finish.

Result: Your Visual Studio Code should open and look like the default welcome screen.

Mark "Install VS Code" as Done

Git Setup (Windows/macOS)

Verify Deloitte GitHub Access:

Check your access: Visit https://github.com/Deloitte-US to verify if you have access to Deloitte US repositories.
Request access (if needed): If you don't have access, follow the steps at https://developer.deloitte.com/githubaccess/ to request GitHub access.

What is Git? Git is a tool that helps you track changes to your code and collaborate with others. GitHub is where your team stores and shares code.

Download Git: Go to git-scm.com/download/win and click the link named Git for Windows/x64 Setup.
Run the installer: Find the downloaded file in your Downloads folder, right-click it, and choose Run as administrator. Click "Yes" when asked.
Pick VS Code as your editor: When you see a screen asking about an editor, select Visual Studio Code from the list, then click Next.
Choose the middle PATH option: Look for a screen that says "Adjusting your PATH environment." Select the middle option (should mention "command line and 3rd-party software"), then click Next.
Finish installation: Click Next through the remaining screens, then click Install. When done, click Finish.

Quick Check: Let's verify Git is working!

Open Command Prompt: Press the Windows key, type "cmd", and press Enter.
Check Git version: Type this and press Enter:
💡 Click Copy, then paste in your terminal
```
git --version
```
You should see something like "git version 2.47.0". ✓ Success!

Tell Git Who You Are:

Set your name and email: In the same Command Prompt window, copy these commands one at a time and press Enter after each. Replace "username_deloitte" with your Deloitte username and "username@deloitte.com" with your Deloitte email:
💡 Click Copy, then paste in your terminal
```
git config --global user.name "username_deloitte"
```
💡 Click Copy, then paste in your terminal
```
git config --global user.email "username@deloitte.com"
```

Verify Deloitte GitHub Access:

Check your access: Visit https://github.com/Deloitte-US to verify if you have access to Deloitte US repositories.
Request access (if needed): If you don't have access, follow the steps at https://developer.deloitte.com/githubaccess/ to request GitHub access.

What is Git? Git is a tool that helps you track changes to your code and collaborate with others. GitHub is where your team stores and shares code.

Get admin access: Open the "Privileges" app on your Mac (in Applications folder). Click to grant yourself admin rights. Enter your Mac login password when asked.
Check if Git is already installed: Press Cmd + Space on your keyboard, type "Terminal", and press Enter. A window will open. Type this command and press Enter:
💡 Click Copy, then paste in your terminal
```
git --version
```
If you see a version number, Git is already installed—please proceed to the Tell Git Who You Are section below. If not, continue to the next step.
Install Git (if needed): If Git wasn't installed, macOS will show a popup asking if you want to install "Command Line Developer Tools". Click Install and wait for it to complete (this may take a few minutes). Enter your Mac password if asked.
Optional - Get the latest version: The previous step installs a basic version of Git. For the latest features, you can install Homebrew (a software manager) and then Git. In Terminal, copy and paste this command, then press Enter:
💡 Click Copy, then paste in your terminal
```
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```
Follow the on-screen instructions. Then install Git by typing:
💡 Click Copy, then paste in your terminal
```
brew install git
```
Verify Git is installed: Close Terminal and open it again (press Cmd + Space, type "Terminal", press Enter). Type this command and press Enter:
💡 Click Copy, then paste in your terminal
```
git --version
```
You should see something like "git version 2.47.0". If you do, Git is ready!

Tell Git Who You Are:

Set your name and email: In Terminal, copy these commands one at a time and press Enter after each. Replace "username_deloitte" with your Deloitte username and "username@deloitte.com" with your email:
💡 Click Copy, then paste in your terminal
```
git config --global user.name "username_deloitte"
```
💡 Click Copy, then paste in your terminal
```
git config --global user.email "username@deloitte.com"
```

Verify once: Run git config --global --list to confirm your name, email, helper, and default branch before cloning Deloitte repositories. Git Credential Manager or the macOS keychain will prompt for SSO the first time you push over HTTPS.

Mark "Install Git" as Done

SSH Key Setup

Connect to GitHub (One-Time Setup):

This creates a secure connection between your computer and GitHub so you can download code. Follow every sub-step exactly.

Windows (Git Bash)

Create Your Security Key

Open Git Bash: Press the Windows key, type "Git Bash", and press Enter.
Generate the key: Copy this command and paste it into Git Bash. Replace "username@deloitte.com" with your email:
💡 Click Copy, then paste in your terminal
```
ssh-keygen -t ed25519 -C "username@deloitte.com"
```
Press Enter 3 times: When it asks where to save the key, press Enter. When it asks for a passphrase, press Enter twice to skip.

Activate the Key

First command: Copy and paste this, then press Enter:
💡 Click Copy, then paste in your terminal
```
eval "$(ssh-agent -s)"
```
Second command: Copy and paste this, then press Enter:
💡 Click Copy, then paste in your terminal
```
ssh-add ~/.ssh/id_ed25519
```

Copy Your Key

Copy to clipboard: Run this command:
💡 Click Copy, then paste in your terminal
```
cat ~/.ssh/id_ed25519.pub | clip
```
Your key is now copied (you won't see anything, but trust us!).

Add Key to GitHub

Go to GitHub: Open github.com in your browser and log in.
Open Settings: Click your profile picture (top right) → Settings.
Go to SSH keys: Click SSH and GPG keys on the left.
Add new key: Click the green New SSH key button.
Fill in details: Give it a title like "Work Laptop", then click in the "Key" box and press Ctrl+V to paste.
Save it: Click Add SSH key.

Test Connection

Test it: Back in Git Bash, run:
💡 Click Copy, then paste in your terminal
```
ssh -T git@github.com
```
If asked "Are you sure you want to continue?", type "yes" and press Enter. You should see a success message. 🎉 Done!

Connect to GitHub (One-Time Setup):

This creates a secure connection between your computer and GitHub so you can download code. Follow every sub-step exactly.

macOS (Terminal)

Create Your Security Key

Make sure Terminal is open: Press Cmd + Space, type "Terminal", press Enter.
Generate the key: Copy this command and paste it into Terminal. Replace "username@deloitte.com" with your email:
💡 Click Copy, then paste in your terminal
```
ssh-keygen -t ed25519 -C "username@deloitte.com"
```
Press Enter 3 times: When it asks where to save, press Enter. For passphrase, press Enter twice to skip.

Activate the Key

First command: Copy and paste this, then press Enter:
💡 Click Copy, then paste in your terminal
```
eval "$(ssh-agent -s)"
```
Second command: Copy and paste this, then press Enter:
💡 Click Copy, then paste in your terminal
```
ssh-add --apple-use-keychain ~/.ssh/id_ed25519
```

Copy Your Key

Copy to clipboard: Run this command:
💡 Click Copy, then paste in your terminal
```
pbcopy < ~/.ssh/id_ed25519.pub
```
Your key is now copied (nothing will show, but it worked!).

Add Key to GitHub

Go to GitHub: Open github.com in your browser and log in.
Open Settings: Click your profile picture (top right) → Settings.
Go to SSH keys: Click SSH and GPG keys on the left.
Add new key: Click the green New SSH key button.
Fill in details: Give it a title like "MacBook Pro", then click in the "Key" box and press Cmd+V to paste.
Save it: Click Add SSH key.

Test Connection

Test it: Back in Terminal, run:
💡 Click Copy, then paste in your terminal
```
ssh -T git@github.com
```
If asked "Are you sure you want to continue?", type "yes" and press Enter. You should see a success message. 🎉 Done!

Mark "Configure SSH Keys" as Done

Phase 3 · Execution (Branching)

Follow the path you selected

Each branch restates the full instructions. Buttons remain disabled until all checkboxes or confirmations are complete. Auto-scroll moves you to the next unlocked element.

Branch A · Installer Path

Presents the full installer quick start with OS tabs and every verification detail. Use the "Mark Installer as Complete" button once you finish every sub-step.

Quick Start Installation

What this does: Installs the AI Assist extension, required runtimes, and configures MCP (where applicable).

Download Windows Installer (.exe)

Download and Install

Download and Run: Click the download button. Once the file is downloaded, open it to start the installer.
Trust the File: If a blue "Windows protected your PC" screen appears, click "More info" and then "Run anyway".
Follow the Installer: Click "Next" to go through the setup screens.

Configure Installation

Choose What to Install: When you see a list of "personas," check the boxes for:
- Dev Assist (Base)
- UI Assist
- Design Assist
Choose Runtimes: On the next screen, make sure both Node.js and Python are selected.
Finish Installation: Keep clicking "Next" and then "Install" to complete the setup.

Verify Setup

Check VS Code: Open VS Code. You should see "AI Assist" in your extensions list on the side.
Say Hi to AI Assist: Find the AI Assist chat panel and send a "Hi" message.
Check the Final Setup: Open the MCP Configuration page. Make sure all items have a green light next to them.

How to Check If It Worked

Check AI Assist in VS Code:
Open VS Code, find the AI Assist chat panel, and send a "Hi". If it replies, it's working!
Check Node.js and Python (Optional):
Open Command Prompt (search for "cmd" in the Start Menu). Type the following commands, pressing Enter after each one:
💡 Click Copy, then paste in your terminal
```
node -v
npm -v
python --version
```
You should see version numbers for each command.
Check the Final Setup:
Open the MCP Configuration page and look for green lights next to each item. This means everything is set up correctly.

Common issues: SmartScreen/UAC prompts, corporate security tools, or network/VPN restrictions. If blocked, go to the Manual Setup checklist.

What this does: Installs the AI Assist extension, required runtimes, and configures MCP (where applicable).

macOS: If you see “unidentified developer”/Gatekeeper, right-click the app → Open. If blocked, allow in System Settings → Privacy & Security.

Prepare the Installer

Download and Unzip: Click the download button. Find the downloaded .zip file and double-click it to unzip. Important: Don't open the app inside yet!

Download macOS Installer (.zip)

Get Admin Rights: Open the "Privileges" app on your Mac. This gives you permission to install things.
Move the App: Drag the unzipped installer app into your "Applications" folder.

Run the Installer

Allow the App to Run: Open the "Terminal" app (you can search for it). Copy and paste the command below and press Enter. You'll need to type your Mac password (it won't show as you type).
💡 Click Copy, then paste in your terminal
```
sudo xattr -rd com.apple.quarantine /Applications/AI-Assist-Installer-App.app
```
Start the Installer: Now, open the installer from your Applications folder and follow the on-screen steps.

Configure Installation

Choose What to Install: When you see a list of "personas," check the boxes for:
- Dev Assist (Base)
- UI Assist
- Design Assist
Choose Runtimes: On the next screen, make sure both Node.js and Python are selected.
Finish Installation: Keep clicking "Next" and then "Install" to complete the setup.

Verify Setup

Check VS Code: Open VS Code. You should see "AI Assist" in your extensions list on the side.
Say Hi to AI Assist: Find the AI Assist chat panel and send a "Hi" message.
Check the Final Setup: Open the MCP Configuration page. Make sure all items have a green light next to them.

Verification

Open VS Code and confirm “AI Assist” is installed and enabled.
Open AI Assist chat and send:

💡 Click Copy, then paste in AI Assist chat

Hi

Verify Node.js and npm in Terminal:

💡 Click Copy, then paste in your terminal

node -v
npm -v

Verify Python:

💡 Click Copy, then paste in your terminal

python3 --version

Expected versions: Node.js ≥ 18, Python ≥ 3

Open MCP configuration and ensure servers are listed and enabled (green status).

Common issues: Gatekeeper blocks, corporate security tools, or network/VPN restrictions. If blocked, go to the Manual Setup checklist.

Mark Installer as Complete

Branch B · Manual Setup Checklist

Complete each step below to set up Node.js, Python, AI Assist extension, MCP servers, and VS Code folder configuration. Expand each accordion, follow the steps, then check "Done" to enable the Finish button.

Node.js Installation

Install the LTS build and confirm node/npm.

Not started

Node.js Installation

Visit Node.js Official Website
Download the “Windows Installer (.msi)” for the LTS version.
Run the installer and complete the wizard (PATH is configured by the official installer).
Verify in Command Prompt or PowerShell:

💡 Click Copy, then paste in your terminal

node -v
npm -v

Visit Node.js Official Website
Download the “macOS Installer (.pkg)” for the LTS version.
Open the .pkg and complete the installer; provide your Mac password if prompted (admin privileges required).
Verify in Terminal:

💡 Click Copy, then paste in your terminal

node -v
npm -v

Mark Node.js checklist as done

Python Installation

Install Python 3, add PATH entries, and verify the interpreter.

Not started

Python Installation

Open the official Python Website and click the Download Python button.
Run the Python installer by right-clicking the installer and selecting “Run as administrator”.
Check Use admin privileges.
Check Add Python to PATH (recommended) or add manually later.
Click Customize installation. If you see a screen named Optional features, check all boxes and click Next.
Set Customize install location to C:\Program Files then click Install.
Once installation is completed, select Disable path length limit in the installation wizard, then verify Python installation.
Finish installation.

PATH Setup (if python installation was complete but verification failed):

If the Python installer did not add Python to PATH, add it manually so the python command works in any terminal.

To add Python to PATH, do the following:

In the Start menu, search for “Environment Variables for your account” and press Enter.
Click “Environment Variables…” to open the overview screen.
Under System Variables, select Path and click Edit.
In the Edit Environment Variable window, click New and add:
- C:\Program Files\Python311\ (Use actual path from your program files)
- C:\Program Files\Python311\Scripts\ (Use actual path from your program files)

Verify in Command Prompt:

💡 Click Copy, then paste in your terminal

python --version

Visit Python Website (macOS is detected automatically) and download the latest installer.
Open the package and complete the install wizard (default settings are fine); provide your Mac password if prompted (admin privileges required).
For Apple Silicon (M1/M2/M3), use the universal installer (modern installers support Apple Silicon).
After installation completes, a Python folder opens.

Verify in Terminal:

💡 Click Copy, then paste in your terminal

python3 --version

Mark Python checklist as done

AI Assist Installation

Install the VSIX, log in with Deloitte SSO, and send "Hi".

Not started

AI Assist Installation (Windows/macOS)

Download the VSIX file (AI Assist). Connect to Deloitte VPN (Mandatory).
Open VS Code → Extensions (left sidebar).
Click the 3-dot menu → “Install from VSIX...”
Select the provided .vsix file for AI Assist.
Restart VS Code.
Verify installation: look for the AI Assist logo in the left sidebar.
Open the AI Assist extension.
Login using Deloitte SSO (email + password). Complete browser authentication → you’ll be redirected back to VS Code.

Note : The “Configure LLM” and “Verification” steps of AI Assist will be completed during the hands-on session. You can review the steps below for reference.

Configure LLM

Click “Select Model / API Provider” at the bottom of the chatbot.
Click “Use your own API Key”.
Select the API Provider (LLM).
Paste the API key.

Note: If a prompt appears at the bottom-left to “Restart VS Code,” click it to complete installation.

Verification: Send "Hi" to AI Assist

Open the AI Assist chat panel in VS Code.
Type the following message and press Enter:

💡 Click Copy, then paste in AI Assist chat

Hi

You should receive a greeting response within a few seconds.
If there is no response:
- Confirm you are signed in with Deloitte SSO.
- Ensure your LLM provider and API key are configured in AI Assist.
- Connect to Deloitte VPN.

Mark AI Assist installation as done

Setup the MCP

Paste the JSON config and confirm servers show green.

Not started

Setup the MCP

Note: Perform MCP setup only after AI Assist installation and verification are completed.

In the AI Assist extension, click the top icon to configure servers.
Open “Installed” and click “Configure”. A JSON file will open.
Copy and paste the following JSON into the opened file:

Show MCP JSON configurationHide MCP JSON configuration

💡 Click Copy, then paste in your Agent Assist settings

{
  "mcpServers": {
    "design-mcp": {
      "autoApprove": [],
      "disabled": false,
      "timeout": 60,
      "type": "streamableHttp",
      "url": "https://agentic-uat.eng.deloitte.com/ui-design/mcp",
      "headers": {
        "Authorization": "Bearer {{token}}",
        "Content-Type": "application/json",
        "X-Client-ID": "agent-assist-extension"
      }
    },
    "ui-developer-mcp": {
      "autoApprove": [],
      "disabled": false,
      "timeout": 60,
      "type": "streamableHttp",
      "url": "https://agentic-uat.eng.deloitte.com/ui-developer/mcp",
      "headers": {
        "Authorization": "Bearer {{token}}",
        "Content-Type": "application/json",
        "X-Client-ID": "agent-assist-extension"
      }
    }
  }
}

Press Ctrl + S (or Cmd + S) to save.
In the AI Assist tab, you should see the MCP Servers listed and enabled.
If everything is green and enabled, the connection is successful; otherwise review the displayed errors.
Click “Done”.
After configuration, verify it is working in the extension.

Mark MCP configuration as done

Create a VS Code Folder

Open a dedicated workspace folder for your assets.

Not started

VS Code Folder Creation

Click “File” → “Open Folder…”.
Or use the “Open Folder” button from the welcome screen.
Navigate to the folder you want to use (Desktop, Documents, Downloads) and click “Select Folder”.

Why this matters: Working within a specific folder keeps all your code and assets organized and makes collaboration easier.

Mark VS Code folder setup as done

Install VS Code, Git, and Configure SSH Keys

VS Code Installation

Choose your installation path

Installer (Recommended for Beginners)

Manual Setup (Advanced)

Follow the path you selected

Branch A · Installer Path

Quick Start Installation

Download and Install

Configure Installation

Verify Setup

How to Check If It Worked

Prepare the Installer

Run the Installer

Configure Installation

Verify Setup

Verification

Branch B · Manual Setup Checklist

You are all set! 🎉