---
name: terminal
description: >
  Command line, npm, git, and shell basics. Activated when Claude runs Bash commands.
  Demystifies the terminal for non-technical users.
---

# Terminal & Command Line — CodeSensei Teaching Module

## The Terminal
- **Analogy:** The terminal is like texting your computer. Instead of clicking buttons, you type instructions and it responds. It's not scarier than that.
- **Key insight:** Everything you can do by clicking in a graphical interface, you can do faster by typing in the terminal. Developers prefer typing because it's faster and scriptable.

## Essential Commands
Teach these as they appear in the user's session:

### Navigation
- `cd [folder]` — "Change Directory" — walk into a folder
- `ls` — "List" — see what's in the current folder
- `pwd` — "Print Working Directory" — "where am I right now?"
- **Analogy:** You're in a building. `cd` is walking to a room, `ls` is looking around, `pwd` is checking the room number on the door.

### File Operations
- `mkdir [name]` — "Make Directory" — create a new folder
- `touch [file]` — create a new empty file
- `cp` — copy, `mv` — move/rename, `rm` — delete
- **⚠️ Teach:** `rm` is permanent. There's no trash can.

### npm (Node Package Manager)
- **Analogy:** An app store for code. Other developers built tools and shared them. `npm install` downloads those tools into your project.
- `npm install [package]` — download and add a tool
- `npm run [script]` — run a pre-defined task (like "start the server" or "run tests")
- `package.json` — the shopping list of all tools your project uses
- `node_modules/` — the warehouse where downloaded tools live (never edit this!)

### git (Version Control)
- **Analogy:** A time machine for your code. Every "commit" is a save point you can go back to.
- `git add` — stage changes (put items on the "to save" pile)
- `git commit` — save a snapshot with a description
- `git push` — upload your snapshots to the cloud (GitHub)
- `git pull` — download the latest from the cloud
- **Key insight:** Git exists because code breaks. It lets you undo mistakes by going back to when things worked.

### Environment Variables
- **Analogy:** Secret notes that your app can read but aren't written in the code itself. Like a password you whisper instead of writing on a whiteboard.
- `.env` file — where secrets live (API keys, database passwords)
- **⚠️ Teach:** NEVER commit .env files to git. That's like posting your passwords publicly.

## Scary-Looking but Simple
- `|` (pipe) — sends output from one command as input to another, like a conveyor belt
- `>` — saves output to a file instead of showing it on screen
- `&&` — "do this AND THEN do that" (run two commands in sequence)
- `sudo` — "do this as administrator" (the master key)