tty.help
Appearance

Display preferences are saved in this browser.

5 minute field note

Read a command before you run it

A calm, repeatable way to turn a wall of terminal text into a decision.

Start with the program

In grep -n "error" app.log, grep is the program, -n is an option, "error" is the search pattern and app.log is the input. Quotes group characters and control how the shell interprets them.

Find the target

Ask which files, directory, server or account this touches. Relative paths depend on the current working directory. A command copied from an agent can be correct for a different directory and wrong for yours.

Read the whole line

The shell processes operators, expansions and redirections. A familiar first word is not enough: cat notes.txt > backup.txt can replace backup.txt.

Ask the agent for evidence

Ask: What will change? Which exact paths or remote destinations are involved? What permissions does this need? How do we undo it? Can we inspect the targets first? A confident explanation is not a verification.

Your next step

Pick one command from your agent’s last explanation. Identify its purpose, target and possible side effects before deciding whether to run it.

Explore the field guide