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.
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
- Press
⌘\to show or hide it. The menu item is View → Show Tab Sidebar or View → Hide Tab Sidebar. - Find the project rail, the column of project tiles. A project is a folder shortcut; you'll make one in the Projects lesson.
- Find the tab list beside the rail. It lists the tabs in this window for the selected project.
- 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.
- Press
⇧⌘\to show or hide it (View → Show Right Sidebar). - Look at the strip across the top. Five tabs always show: Agent, Prompts, Queue, Files and Web.
- 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.
- Pick Notes. While a tab from the menu is showing, the menu's label changes from More to that tab's name.
- 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.
- Press
⇧⌘Pto open the command palette (View → Command Palette). - Type a verb such as
split,themeortour. - 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
- Press
⌘Kto open the Quick Switcher (View → Quick Switcher). - 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
- 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. - 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.
⇧⌘Pfollowed bytourfinds the first-run tour.
Go further
- Orientation — every tab, setting pane and hotkey in one page
- Keybinds — the shortcuts worth learning
- Settings — how the Settings window relates to your config file
- Next lesson: Tabs, splits and the Quick Terminal