Navigating the Filesystem

By the end of this lesson, you will be able to move around your computer’s filesystem entirely through the terminal — checking where you are, seeing what’s around you, and going wherever you need to go.

The mental model: a building with rooms

Think of your computer’s filesystem like a building:

• / (root) is the ground floor — everything is inside it
• /home is the residential floor
• /home/user is your apartment (your home directory)
• /home/user/projects is a room in your apartment
• /home/user/projects/my-app is a drawer in that room

Right now, when you want to find a file, you open Finder or File Explorer and click through folders. In the terminal, you do the same thing — but by typing instead of clicking. For beginner navigation, these three commands are enough for most tasks.

The big three commands

These three commands are like having a map, a flashlight, and your legs:

• pwd = look at the map (where am I?)
• ls = shine the flashlight (what’s around me?)
• cd = walk to a new room (go somewhere)

Try it yourself

Here’s a simulated terminal with a pre-built filesystem. Work through the exercises below — each one builds on the last.

Step 1: Where am I?

Type pwd and press Enter.

You’ll see /home/user — that’s your current location (your “home” directory). Think of it as the address of the room you’re standing in.

Step 2: What’s here?

Type ls and press Enter.

You’ll see a list of files and folders in your current directory. This is like opening a folder and seeing its contents.

Step 3: Go somewhere

Type cd projects to move into the projects folder, then ls to see what’s inside.

Step 4: Go deeper

Now that you’re in projects, go into my-app:

Step 5: Go back

Type cd .. to go back up one level. The .. means “the folder above this one.”

Step 6: Go home

No matter where you are, cd ~ takes you straight home:

Paths: absolute vs relative

There are two ways to describe a location, just like there are two ways to give directions:

Absolute path — the full address from root (like a street address):

cd /home/user/projects/my-app

Relative path — from where you currently are (like “turn left, then go two blocks”):

cd projects/my-app

If you’re already in /home/user, both commands take you to the same place. Relative paths are shorter, so people use them more often in daily work.

Special path shortcuts

Putting it together: a real navigation session

Here’s what a typical session looks like. Follow the comments to understand each step:

pwd                         # Where am I?
ls                          # What's here?
# documents  projects  downloads  hello.txt

cd projects                 # Go into projects
ls                          # What projects do I have?
# my-app  data-analysis

cd my-app                   # Go into my-app
ls                          # What files are here?
# index.html  style.css  README.md

cd ../..                    # Go up two levels (back to /home/user)
pwd                         # Verify I'm home
# /home/user

Notice the pattern: navigate, look, navigate, look. You’re constantly alternating between cd (move) and ls (look around). This is how everyone uses the terminal — even experienced developers.

Practice challenge

Try this sequence in the terminal simulator above:

1. Start at /home/user (run cd ~ if you’re not there)
2. Navigate into projects/data-analysis
3. Read the contents of notes.txt (use cat notes.txt — cat prints a file’s contents to the screen)
4. Go back to your home directory
5. Navigate into documents and list the files there

Key takeaways

• Three commands are all you need to navigate: pwd (where am I?), ls (what’s here?), cd (go somewhere).
• The filesystem is a tree of nested folders. cd moves you down into folders, cd .. moves you back up.
• Absolute paths (starting with /) give the full address. Relative paths give directions from where you are now.
• ~ always means your home directory — cd ~ is your “home button.”
• Use Tab completion to avoid typos: type the first few letters of a folder name and press Tab.
• When in doubt: pwd to check where you are, cd ~ to go home, ls to look around.

What’s next

You can now navigate anywhere on your computer through the terminal. In the next lesson, you’ll learn the essential commands for creating, moving, and deleting files — the building blocks for everything else.