/setup-extensions.en

description: "Lesson command"
duration: "~5 min"
prerequisites: ["Cursor is running"]
level: "beginner"
tags: ["setup", "extensions"]
nonInteractiveMode: incompatible

/setup-extensions -- Automatic Extension Setup

Step 0: Check Setup Progress

**What the AI auto-runs:** 1. Run `uv run python tools/setup_progress.py show --current setup-extensions` to display progress 2. Check already-installed extensions; if all are present, confirm "Extensions are already installed. Do you want to skip?"

Purpose of This Command

The AI **automatically checks and installs** Cursor / VS Code extensions. You don't need to run any terminal commands. The AI handles everything behind the scenes.

| Item | Details | |------|---------| | Goal | Automatically install all extensions required for the training | | Duration | ~5 minutes | | Prerequisites | Cursor (or VS Code) is running | | User Action | Just press buttons (no CLI commands needed) |

> **Key point**: All operations in this command are auto-run by the AI. You don't need to type commands in the terminal.

---

Readiness Check

**AskQuestion configuration:**

{
  "title": "Starting extension setup",
  "questions": [{
    "id": "readiness",
    "prompt": "Are you ready?",
    "options": [
      {"id": "ready", "label": "Let's start"},
      {"id": "what_is_this", "label": "What are extensions? I want an explanation first"},
      {"id": "different_lesson", "label": "I want to go to a different lesson"}
    ]
  }]
}

(ready -> Proceed to Step 1) (what_is_this -> Display the following)

> **What are extensions?** > They are like "feature packs" you can add to Cursor (the editor). > For example, installing the "Python extension" enables syntax highlighting and auto-completion for Python code. > This setup automatically installs the extensions needed for the training.

(different_lesson -> Display module list)

---

Step 1: Check Current Extensions

**What the AI auto-runs:**

1. The AI runs the following command **behind the scenes** to get the list of installed extensions:

cursor --list-extensions 2>/dev/null || code --list-extensions 2>/dev/null

2. Display the list in an easy-to-read table format for the user:

Currently installed extensions:
| # | Extension ID | Description |
|---|-------------|-------------|
| 1 | ms-python.python | Python |
| 2 | ... | ... |

Total: XX extensions are installed.

3. If the command fails (neither `cursor` nor `code` is found):

• Display "Cursor command-line tool was not found"
• **For Cursor**: Guide: "Open the Cursor menu > Command Palette (Cmd+Shift+P / Ctrl+Shift+P) > select 'Shell Command: Install 'cursor' command'"
• **For VS Code**: Guide: "Open the Command Palette > select 'Shell Command: Install 'code' command in PATH'"
• After resolving, re-run Step 1

**Note: Do not ask the user to type commands. The AI auto-runs everything and only shows results.**

---

Step 2: Auto-Install Required Extensions

**What the AI auto-runs:**

1. Compare the "required extensions list" below with the Step 1 results and identify missing extensions:

| Extension ID | Purpose | |-------------|---------| | `marp-team.marp-vscode` | Create presentations in Markdown (Marp) | | `hediet.vscode-drawio` | Create and edit diagrams in the editor (Draw.io) | | `jebbs.plantuml` | Auto-generate UML diagrams from text (PlantUML) | | `nicepkg.aide-pro` | AI development assistant (AIDE Pro) | | `ms-python.python` | Python code execution and debugging | | `ms-python.vscode-pylance` | High-accuracy Python completion and type checking | | `esbenp.prettier-vscode` | Automatic code formatting (Prettier) |

2. If missing extensions are found, report to the user and install:

The following extensions are not installed. Installing automatically:
- marp-team.marp-vscode (Markdown presentations)
- hediet.vscode-drawio (Diagram editor)

Installing...

3. Install each extension with the following command **behind the scenes**:

cursor --install-extension {extension_ID} 2>/dev/null || code --install-extension {extension_ID}

4. If all are already installed:

All required extensions are already installed (7/7).

5. Report installation results one by one:

| Extension | Status |
|-----------|--------|
| Marp | Installation complete |
| Draw.io | Installation complete |
| PlantUML | Already installed |
| ... | ... |

**Note: The AI auto-runs the install commands. Only results are shown to the user.**

---

Step 3: Recommended Extensions

**AskQuestion configuration:**

{
  "title": "Install recommended extensions too?",
  "questions": [{
    "id": "optional_install",
    "prompt": "The following extensions are not required but are useful to have. Would you like to install them?\n- Git Graph: Visualize Git history\n- GitLens: Show change history for each line\n- Markdown All in One: Convenient Markdown features bundle",
    "options": [
      {"id": "yes_all", "label": "Install all of them"},
      {"id": "choose", "label": "I want to choose which ones to install"},
      {"id": "skip", "label": "Skip for now"}
    ]
  }]
}

(yes_all -> Auto-install all of the following) (choose -> Let user select individually via AskQuestion) (skip -> Proceed to Step 4)

**Recommended extensions list:**

| Extension ID | Purpose | |-------------|---------| | `mhutchie.git-graph` | Display Git history as a graph (see branch flow at a glance) | | `eamodio.gitlens` | Show the last author and date of each line | | `yzhang.markdown-all-in-one` | Convenient Markdown editing features (auto table of contents, shortcuts, etc.) |

**What the AI auto-runs:**

• Install selected extensions with `cursor --install-extension {ID} 2>/dev/null || code --install-extension {ID}`
• Report results in table format

**(For choose) AskQuestion configuration:**

{
  "title": "Select extensions to install",
  "questions": [
    {
      "id": "git_graph",
      "prompt":