start-0-1.en

Prompt file imported from minicoohei/ai-agent-camp (.cursor/commands/lesson/start-0-1.en.md). Copyright stays with the author.

Lesson 0-1: Environment Setup Verification

Check Setup Progress

Auto-run by AI: Run uv run python tools/setup_progress.py show to display the current setup progress.

What You'll Do

Hint: If the AI stops responding midway, type "please continue" or "it stopped" to resume.

How to Set Up

In this lesson, you will use the following two commands to set up your environment. No terminal operations required. The AI handles everything automatically.

Note for Codex: In Codex, instead of running /setup-start or /check-setup directly as Cursor slash commands, follow the verification steps written in this file in order. When GUI operations like browser authentication are needed, switch to manual user operation at that point.

Step 0: Enable the Security Hook

Auto-run by AI: Run bash scripts/install_hooks.sh. It is safe to run repeatedly and enables the secret scan that runs before each commit.

Step 1: Start Setup

Run /setup-start first. This command automatically performs the following:

• Detect your OS (Mac / Windows)
• Check for Python / Node.js / Git / GitHub CLI and their versions
• Provide GUI installer URLs for any missing tools

AskQuestion settings:

{
  "title": "Step 1: Start Setup",
  "questions": [{
    "id": "action",
    "prompt": "Let's start setting up your environment. What would you like to do?",
    "options": [
      {"id": "run_setup", "label": "Start setup (run /setup-start)"},
      {"id": "run_check", "label": "Run environment check only (run /check-setup)"},
      {"id": "already_done", "label": "Already set up"},
      {"id": "view_html", "label": "View the course page first"}
    ]
  }]
}

(run_setup -> Run the contents of /setup-start) (run_check -> Run the contents of /check-setup) (already_done -> Go to Step 2) (view_html -> Provide the course page URL https://ai-agent.camp/en/course/module-0)

Step 2: GitHub Settings and Personal Repository Creation

Run /setup-github. This command automatically performs the following:

• Check for a GitHub account
• Auto-launch the browser for GitHub login (gh auth login --web)
• Auto-create your personal private repository

AskQuestion settings:

{
  "title": "Step 2: GitHub Settings",
  "questions": [{
    "id": "github_action",
    "prompt": "We'll configure GitHub. What would you like to do?",
    "options": [
      {"id": "run_github", "label": "Start GitHub setup (run /setup-github)"},
      {"id": "already_done", "label": "Already logged in to GitHub & have my own repo"},
      {"id": "skip", "label": "Skip and go to the next lesson"}
    ]
  }]
}

(run_github -> Run the contents of /setup-github) (already_done -> Go to completion check) (skip -> Go to the next step)

Step 3: Comprehensive Environment Check

Once all setup is complete, run /check-setup to verify the state of your environment. The AI will automatically check all of the following and display a report:

• Basic tools (Python, Node.js, Git, GitHub CLI)
• Authentication & APIs (GitHub auth, Gemini API, Slack API)
• Project settings (.env, .gitignore, security hooks)
• Extensions

If any items have issues, the AI will auto-fix them or guide you to the appropriate setup command.

Commands to Run

/setup-start
/setup-github
/check-setup

Expected Output Example

Environment Check Report
| Item       | Status | Details        |
|-----------|--------|---------------|
| Python    | OK     | 3.12.x        |
| Node.js   | OK     | 24.x          |
| Git       | OK     | 2.x           |
| GitHub CLI | OK    | Logged in      |

Common Troubleshooting

• AI response stops -> Type "please continue"
• GitHub authentication fails -> Re-run /setup-github
• Tool not found -> Install from the installer URL provided by the AI

Checkpoint

• Codex Desktop or Cursor launches successfully
• Python 3.9 or higher is installed
• Node.js 18 or higher is installed
• Git is installed
• Logged in to GitHub CLI
• Pushed to your own private repository

Next Steps

AskQuestion settings:

{
  "title": "Choose Next Step",
  "questions": [{
    "id": "next_step",
    "prompt": "What would you like to do next?",
    "options": [
      {"id": "next", "label": "Install extensions (/start-0-2)"},
      {"id": "gemini", "label": "Set up Gemini API (/start-0-3)"},
      {"id": "check", "label": "Run environment check (/check-setup)"},
      {"id": "finish", "label": "Finish here"}
    ]
  }]
}

(next -> Guide to /start-0-2) (gemini -> Guide to /start-0-3) (check -> Run the contents of /check-setup) (finish -> End)