🎓 AIIQM-WELL University · Foundation · Module F3 of 5

Crossing the Moat
— The Terminal Made Simple

45–60 min
📋 Prerequisites: VS Code installed (F2)
📊 Foundation Level
Lesson Outcome: You can navigate your file system, create files, and run basic commands in the terminal without hesitation.
AIMY Opening

Before We Begin

The terminal has a reputation it doesn't deserve. It looks like something from a 1980s movie about hacking. It isn't. It's just a text-based way to talk to your computer — and once you learn four commands, you'll wonder why you ever used anything else for file navigation.

Here's the truth: you are already using the terminal. You used it in F2. You typed echo and pressed Enter. That was a terminal command. This module is about understanding what you already did — and adding four more tools to your set.

We are not becoming command-line experts. We are crossing the moat. On the other side: the ability to navigate your project, run Python scripts, and use Git — all of which require the terminal.

Analyze Phase

The Five Commands You Actually Need

The entire terminal vocabulary you need for this course is five commands. That's the list. Learn these, and the terminal stops being intimidating. You already know one: echo. Here are the other four.

01
pwd — Print Working Directory

Shows you exactly where you are in the file system. Type it when you're lost. It always tells you the full path from root to your current location.

02
ls (Mac/Linux) / dir (Windows) — List Contents

Lists everything in the current folder. Type it to see what's here. On Mac and Linux use ls. On Windows use dir. Both show files and folders in your current location.

03
cd [foldername] — Change Directory

Moves you into a folder. Type cd my-folder to enter it. Type cd .. (two dots) to move up one level. This is how you navigate the tree.

04
mkdir [name] — Make Directory

Creates a new folder. Type mkdir my-project to create a folder called my-project. Works on all operating systems.

05
touch [filename] (Mac/Linux) / echo.> [filename] (Windows)

Creates a new empty file. The first file in every project starts this way. On Mac/Linux use touch notes.txt. On Windows use echo.> notes.txt. Both create an empty file with the name you provide.

Integrate Phase

Navigate Your Workspace

You're going to navigate your workspace using only the terminal. No mouse, no file explorer — just commands.

01
Open VS Code

Open VS Code with your aiiqm-workspace folder. Open the integrated terminal using View → Terminal or Ctrl+`.

02
Find Your Location

Type pwd and press Enter. You should see the full path to aiiqm-workspace. This is where you are right now.

03
List What's Here

Type ls (Mac) or dir (Windows) and press Enter. The folder is empty for now — that's correct. You should see the terminal is ready for your next command.

04
Create a Folder

Type mkdir foundation-notes and press Enter. You've created a new folder called foundation-notes.

05
Navigate Into It

Type cd foundation-notes and press Enter. You've moved inside the folder.

06
Confirm Your Location

Type pwd again — you're now inside foundation-notes. The path should end with /foundation-notes or \foundation-notes (depending on Mac/Linux or Windows).

07
Create a File

Create a file: touch notes.txt (Mac) or echo.> notes.txt (Windows). You've created an empty text file.

08
Verify It Exists

Type ls / dir — you should see notes.txt in the output. It's there.

09
Navigate Back

Type cd .. to return to aiiqm-workspace. You've moved up one level. Type pwd to confirm.

Manage Phase

Control Your File System

You can now orient yourself in any project folder and create the structure you need without touching the mouse. This is control. The terminal isn't a scary place — it's precision.

PTR — Prove The Result

Verify that you can navigate and create files by completing these checks:

  1. You ran pwd and saw the correct path to your workspace.
  2. You created the foundation-notes folder using mkdir and saw it confirm.
  3. You navigated into it and back out using cd and cd ..
  4. You created notes.txt and confirmed it with ls/dir.

Common Mistakes

⚠ "Permission denied"
This usually means you're trying to create a file somewhere you don't own. Make sure you're inside your own workspace folder, not in C:\\ or /. Use pwd to confirm your location.
⚠ "cd doesn't work"
Folder names are case-sensitive on Mac/Linux. Type ls/dir first to see the exact name, then cd into it with the correct capitalization.
⚠ Getting lost
pwd always tells you where you are. cd ~ on Mac/Linux or cd %USERPROFILE% on Windows takes you home. From there you can navigate to your workspace.
Module Checkpoint

Before You Move On

✓ Verify These Four Things
  1. You ran pwd and know what it shows — your current location in the file system.
  2. You created a folder with mkdir and confirmed it with ls/dir.
  3. You navigated in and out of a folder with cd and cd ..
  4. You created a file and confirmed its existence with ls/dir.
AIM Commitment

What You Proved Today

You crossed the moat. The terminal is no longer an alien place — it's a tool you can use with confidence. Navigation and file creation are now part of your skill set.

  1. Analyze: You understood that the terminal is a text interface with five essential commands — not a hacking tool.
  2. Integrate: You navigated your workspace, created a folder, created a file, and moved between directories using only commands.
  3. Manage: You can now orient yourself in any project folder and create the structure you need without touching the mouse.