PF-04 · Project folders

Open Terminal in That Folder

Make the first prompt land inside the project — not home.

20–35 min Needs: PF-03 Outcome: repeatable terminal-here method

Who this is for

Beginners who always open Terminal from Spotlight/Start and land in ~.

Which machine are you on? (saved across terminal + folder lessons)

↑ Pick one to see only your path. (Showing all until you do.)

The emergency brake

  • Terminal opened at home again? That’s the default, not a failure. Use the open-here method below — or just cd with your written path.
  • IDE opened the wrong folder? Close it (no saving needed) and use Open Folder on my-app only.

Open in terminal once

About 10–15 min

Two valid patterns — pick one and stick to it:

  1. Explorer → Open in Terminal → agent (cwd set before the agent), or
  2. IDE Open Folder → integrated terminal → agent (cwd = opened folder).
  1. Finder: drag the project folder onto the Terminal icon — or copy the path and cd to it.
  2. Explorer: click the address bar, type powershell or wt, press Enter. Or right-click → Open in Terminal where shown.
  3. Open Ubuntu, then cd to the path. Or from PowerShell: wsl --cd /home/you/projects/my-app.
go there by cdmacOS
cd ~/Documents/Projects/my-app
go there by cdPowerShell
cd $env:USERPROFILE\Documents\Projects\my-app
go there by cdWSL
cd ~/projects/my-app

Try this

Open a terminal in your project using one method above. Do not launch an agent yet.

You should see: a prompt whose path ends in your project name. Type pwd to confirm — the leaf folder should be my-app.

Don't

Launch the agent first from home, then ask it to “go find my project among 200 folders.” Folder first, agent second.

Try the IDE route (optional)

About 10 min

  1. If you use Cursor or VS Code: File → Open Folder… on my-app only — not Projects, not home.
  2. Open the integrated terminal. Confirm pwd shows the project.

Write your habit note

About 5 min

  1. Write which method you’ll use daily: Finder/Explorer or IDE Open Folder. Stick to it for a week.

Success check

  • Terminal opened in the project (or you cd’d before anything else)
  • Method written for next time

Common failure modes

FailureFix
Terminal opens at ~ every timeUse Open-in-Terminal / Open Folder; or keep a snippet with your cd path
IDE opened parent ProjectsClose; Open Folder on my-app
Windows “Open in Terminal” missingUse address-bar powershell / Windows Terminal, or cd manually

Don't buy open-here tools

Don’t install a third-party “terminal here” shareware for this module — the built-in methods above are enough.

Stuck with a named error or a confusing path?

Bring the exact path and the exact error text to a free 30-minute consult. Copy them first — vague “it doesn't work” wastes the call.

Book free