Northern Commander

The command line

The row under the panes is your shell’s prompt. Type a command there with the panes still in view: pick a file with the arrows, put its name on the line, run it, and carry on where you were.

KeyAction
⌘LCommand line
⌘F5Insert from the panes…
⌘F8Command history…
⌥⌘OTerminal

Taking the line

⌘L puts the keyboard on the line, and the same key gives it back to the panes. What you typed stays on the line when you leave it.

The shell's own prompt under the panes. The pane's cursor still moves while the line has the keyboard.
  • The first time, it starts the shell, in the active pane’s folder.
  • Each time, it moves the shell to the active pane’s folder first, so the prompt already says where a command will run. Nothing is typed to do it — see moving the shell.
  • If the shell is still running something, it is left alone, and the line becomes a new tab of its own in the active pane’s folder. Bring the terminal up and that tab stays if you ran or typed anything in it; if not, it closes and you see the busy one.
  • While the terminal stands beside a pane, there is no line: that terminal is where commands are typed.

Which keys are whose

While the line has the keyboard, the pane keeps its cursor and the application keeps its own keys. The rest go to the shell.

Press And
↑ ↓ Page Up Page Down Home End Move the active pane’s cursor, marking as they go with ⇧, as over the panes
⌘← · ⌘→ Make the left or the right pane the active one
⌥↑ · ⌥↓ The shell’s own history, sent as the plain arrows
← →, Tab, typing and ⌃ keys The shell’s: moving along the line, completion, editing
Esc Clears what is typed. On an empty line, gives the keyboard back to the panes
Enter Runs the line — below
⌘V Pastes
⌘F5 · ⌘Enter The line’s menu — below
Function keys, and other keys with ⌘ The application’s, as over the panes — F3 views the file under the cursor
  • On a side whose Option key is set to meta — Left Option key, Right Option key — ⌥↑ and ⌥↓ go to the shell as they are instead.
  • Pasted text with a line break or another control character in it is refused, with a notice, where the shell has not asked for pasted text to be marked: that shell would run each line as it arrived.
  • The shell’s own keys work as they always do: ⌃R searches its history, ⌃C abandons the line.

Running a command

Enter sends the line, and the keyboard stays on it. Whether you see the full terminal depends on the command:

  • One that ends at once — within 300 ms as shipped, Terminal after, in ms — leaves you on the panes, with a notice of how it went.
  • One still running after that brings the full terminal up, so you can watch it or answer it.
  • One that takes the whole screen — an editor, less, top — brings it up at once.

When the command ends, After a command ends decides what is left on the screen. As shipped, you are back on the panes if it printed two lines or fewer — Most lines in a notice — or took the whole screen; otherwise the terminal stays up with its output. If the terminal came up for it and it printed little, the panes come back when it ends.

A quick command's notice. The key at the bottom brings up the terminal with everything it printed.
The notice
A tick or a cross and the exit code — · where the shell did not say — and how long it took. Then what it printed, no output, or as many lines as Most lines in a notice allows and a count of the rest. Last, the key that shows the terminal.
  • It stays four seconds, as Notice stays, seconds says, and takes no key: the next key you press puts it away and does what it always does.
  • A full-screen program that ended well leaves no notice, since there is nothing left to read. One that failed leaves one, without its lines.
  • Without the shell’s integration nothing says when a command ends: the terminal comes up once the delay has passed, and stays.

⌘F3 puts everything the last command printed in the viewer, from the panes as well as from the terminal — see Commands and their output.

What the row shows

With the keyboard, the row is the shell’s prompt and what is typed. It grows over the bottom of the panes while the shell writes more than one row — a list of completions, say — up to six rows, and goes back to one at the next prompt.

Without it, the row shows the first of these that applies:

  1. A copy or other operation waiting for an answer.
  2. A command still running: its latest line of output, as it changes.
  3. An operation’s progress.
  4. A prompt in the active pane’s folder — where a command would run. For a shell the application cannot move, the shell’s own prompt.

A prompt of two lines or more shows only the row you type on, unless Command line shows says whole prompt.

Putting names and paths on the line

⌘F5, or ⌘Enter, opens the line’s menu: what the panes can put on the line, and under it what the line can do.

Each row shows exactly what it would put on the line. A name with a space in it comes quoted.
Key Puts on the line
1 The name under the active pane’s cursor
2 Its full path
3 The names marked in the active pane
4 The full paths marked in the other pane
5 The active pane’s folder
6 The other pane’s folder
  • Each row is written as your shell has to be given it: a plain name as it is, anything else in single quotes. What you see is what arrives.
  • A number always means the same row. A row with nothing to offer is left out, and so are 4 and 6 while the terminal stands in the other pane’s place.
  • A name goes in alone only where the file is in the folder the pane shows; otherwise it is its full path. One that starts with a dash is written ./-name, so no program takes it for an option.
  • It goes in after the cursor with a space after it, ready for the next. A name with a line break in it is refused where the shell has not asked for pasted text to be marked.

In the full terminal, and in a terminal beside a pane, ⌘F5 offers the same six rows alone.

Commands you ran

⌘F8 lists every command the shell reported, newest first, each with the folder it ran in. It works on the command line and in the terminal, and is the first row under the rule in the line’s menu. Anywhere else, or before any command has run, a notice says so.

Pins first, then each command once, with the folder it last ran in.
  • Typing narrows the list to the commands holding what you type, capitals or not. Below those come commands found by their initials or letters in order (gcm for git commit --amend), and a small typo is forgiven when nothing else matches.
  • Tab switches between the commands run in the folder the shell is in now and all of them — Everywhere, each command once, where it last ran. It opens on the folder’s own, unless nothing has run there yet.
  • Enter, or Insert, puts the command on the line in place of what was typed there. It never runs it: read it, change it, and press Enter yourself. Nothing goes onto the line of a shell running a command.
  • Pin (⌥P) keeps a command at the top of both lists, out of reach of the limit — good for the start of one you finish differently each time. Unpin is ⌥U.
  • Remove (⌥R) takes the command out of this folder’s list, or out of every folder’s while Everywhere is shown. On a pin, it takes the pin away.
  • Clear (⌥C) empties the list shown, after asking. Pins stay.

The list is kept from one run to the next, up to 1,000 commands — Commands remembered — and every tab adds to the same one. It needs the shell’s integration.

Running it in your own terminal

The line’s menu can run what you have typed in your own terminal application instead: a Run in row for iTerm2 and for Terminal, whichever are installed, each on ⌥ and its first letter.

  • It opens a new tab in iTerm2, or a new window where Commands open a new says window. Terminal always opens a new window.
  • There it changes to the active pane’s folder, then runs the line exactly as you typed it. The line stays on the command line: running it elsewhere does not take it away.
  • The one named in Your own terminal comes first.
  • Only iTerm2 and Terminal run a typed line in their own shell. Ghostty, kitty and Warp take a program to run rather than a line, so they get no row — ⌥⌘T still opens them.
  • The rows are there only once something is typed, and need the shell’s integration, which marks where typing begins.

Commands from elsewhere

A command from the user menu, or one a file type runs, goes through this line as if typed and Enter pressed. Where the line already has something typed on it, or the shell is busy, it runs in a new tab instead, so what you were typing is never lost.

When the shell ends — you typed exit — the keyboard goes back to the panes, and the next ⌘L starts a new one.