All pages

Lesson 1.2 · Get set up · 10 min

A tour of the window

The terminal, the three sidebars, and where every surface lives.

Listen

This lesson maps the TRMNLY window: the terminal in the middle, a sidebar on each side, and the palette and switcher that reach everything else. By the end you can open any surface without hunting for it.

Time: 10 minutes · Works on: macOS app

The terminal

The middle of the window is a Ghostty terminal. TRMNLY is built on Ghostty, so its tabs, splits, themes, fonts and config file all work the same way. Everything TRMNLY adds lives around the terminal, not inside it.

Above the terminal are two small buttons. The paperclip opens a file picker and types the paths you pick at the cursor (⌃⌘A does the same). The + button holds split, tab, window and layout actions, covered in the next lesson.

The left sidebar

  1. Press ⌘\ to show or hide it. The menu item is View → Show Tab Sidebar or View → Hide Tab Sidebar.
  2. Find the project rail, the column of project tiles. A project is a folder shortcut; you'll make one in the Projects lesson.
  3. Find the tab list beside the rail. It lists the tabs in this window for the selected project.
  4. At the bottom of the rail, find Find in Project and the lock button, which blocks physical input while the agent works.

The right sidebar

The right sidebar is where most of TRMNLY's features live.

  1. Press ⇧⌘\ to show or hide it (View → Show Right Sidebar).
  2. Look at the strip across the top. Five tabs always show: Agent, Prompts, Queue, Files and Web.
  3. Open the More menu at the end of the strip. It holds the other fourteen: Chat, Tasks, Review, Notes, Jobs, Conn, Keys, Docker, Devices, Flows, Local LLM, Activity, Plugins and Help.
  4. Pick Notes. While a tab from the menu is showing, the menu's label changes from More to that tab's name.
  5. Pick Agent again. The sidebar remembers the tab you chose, even after a relaunch.

You can also jump straight to any tab from the menu bar with View → Right Sidebar.

Tab What it's for
Agent Chat with the AI agent and approve what it runs
Prompts Saved prompts you send to the agent, the queue or a pane
Queue Commands staged to run one after another
Files The project's file tree, with preview and editing
Web A browser beside your terminal
Tasks The project's Kanban board
Conn Saved SSH and Mosh hosts, SFTP, port forwards, containers
Help The TRMNLY manual, inside the app

The command palette

When you can't remember where something is, search for it.

  1. Press ⇧⌘P to open the command palette (View → Command Palette).
  2. Type a verb such as split, theme or tour.
  3. Press Return to run the highlighted command.

The palette searches menu actions, open tabs and panes, settings you can change inline, and agent actions.

The Quick Switcher

  1. Press ⌘K to open the Quick Switcher (View → Quick Switcher).
  2. Type part of a tab, project or file name and press Return.

The switcher is for jumping; the palette is for doing.

Settings and help

  1. Press ⌘, to open Settings. The panes run down the left: General, Account, Appearance, Font, Keybindings, Shortcuts, Integrations, API Keys, AI Agent, Notifications, Updates, Profiles, Security, Permissions, Containers, VibeHub and TestFlight.
  2. Press ⌘? (Help → TRMNLY Help). The right sidebar opens on the Help tab, which holds the same pages as trmnly.dev/docs.

Check yourself

  • You can hide and show both sidebars from the keyboard.
  • You can open Tasks from the More menu without looking for it.
  • ⇧⌘P followed by tour finds the first-run tour.

Go further