The sidebar lists the files olai serves and your pinned pages, tabs keep several pages open, and the palette runs commands.
Cmd is the modifier on a Mac; press Ctrl elsewhere.
Read the sidebar
| Section | What it lists |
|---|---|
| Outlines | Outline files, which hold rows, and their folders1 |
| Reference | Every other file olai serves, grouped by folder and collapsed2 |
| olai | The outlines olai keeps for itself, in the _olai/ folder3 |
| Trash | Rows you have put away, pinned at the foot of the column |
| Inbox | Beside Agenda at the top, once the directory has an inbox4 |
Cmd + \ shows or hides the column.
Move between panes
A pane is one page beside another in the same window. Alt + click a link opens it in the pane to the right; Cmd + Shift + W closes one.5 A chat is a pane too.6
Pin a page or a layout
Pinned pages sit in a list between the calendar and the file tree. You can pin a row’s page, a document, a page narrowed with a filter query (Filtering a page), or a layout of panes.789
Keep several pages open
On a desktop a strip of tabs sits above the page, and Cmd + Shift + O opens a new one.10 Each tab holds one page or a split of panes, and keeps its filter and scroll position.1112
Use the palette, and capture a line
Cmd + K opens the palette, a search box with commands under it. It opens pages, searches the directory, runs commands on the row you are zoomed into, and reaches your chats (Search).13 Type + and a line, press Enter, and it goes to the directory’s inbox; you stay on the page.1415 olai surface capture sends a line from a terminal.16
Keep the list of pins in order, and what the naming question takes
Keep the list of pins in order
The naming question is asked in the palette’s own box, with the name the page would take otherwise shown as a placeholder:
| Key | What it writes |
|---|---|
Enter with nothing typed |
Pins the bare address, whose name is read live from the page |
Enter with words |
Pins it under that name, as one row whose title is a Markdown link |
Escape |
Nothing at all, since the question comes before the pin |
A name the link cannot hold, such as one containing ], is refused in the palette’s own line rather than mangled. While the question is up it replaces the list of commands.
Hovering a pin shows a ✎ beside its ×. The ✎ asks the same naming question, holding the name the pin has now, and Enter with nothing typed takes the name off, leaving a bare address drawn by whatever it points at. A rename is an ordinary title edit, so Cmd + Z takes it back; it is refused if another writer has changed that pin’s name or destination in the meantime.
Drag a pin to reorder the list: press, move, and a line shows where it will land. A press that does not move is the click it always was, and Escape cancels a drag you are holding. The × takes a pin off, which puts its row in the Trash keeping its id, so Cmd + Z and Put back both reach it (Moving rows about, and the Trash).
Pin a layout
| Click on a layout pin | What opens |
|---|---|
| A plain click | The layout, in a new tab in front |
Alt + click |
Its pages to the right of the pane you are in |
Alt + Shift + click |
Its pages as new panes |
Cmd + click or middle-click |
Its address in a new browser tab |
Every key for panes and tabs
| Key or click | What it does |
|---|---|
Alt + click a link |
Opens it in the pane to the right |
Alt + Shift + click |
Opens it in a new pane to the right |
Alt + ← / Alt + → |
Moves focus to the neighbouring pane, when you are not typing |
Cmd + Shift + W |
Closes the focused pane |
Cmd + click, middle-click, Shift + click |
The browser’s own: a new browser tab or window |
| A plain click inside a chat’s pane | Opens it in the pane to the left, or in one opened to the right |
| What you want | How |
|---|---|
| A new tab | Cmd + Shift + O, the + at the end of the strip, or Open in new tab from a link’s menu |
| The next or previous tab | Cmd + Shift + . and Cmd + Shift + ,, or click one |
| Close the tab in front | Cmd + Shift + X, the × on it, or a middle-click |
| A copy of a tab, or only this one | Right-click a tab for Duplicate tab and Close other tabs |
| Reorder them | Drag a tab along the strip |
What the palette offers on a row, and how its levels work
Use the palette
On a zoomed row’s page, the palette lists what that row can take: Mark: To do, Mark: Doing, Mark: Done, Mark: Cancelled, Mark: Clear, Clear date, Duplicate and Move to Trash. Each one names the row it is about on its second line, and on any other page none of them are listed. The four commands that ask you something first stay where the asking happens: Set date…, Set repeat…, Link to… and Wait for… all open a panel under a row (Typing an outline, Moving rows about, and the Trash).
The palette asks Move to Trash’s question in its own box, with the same sentence and count the row’s menu uses. The question takes the caret while it is up, so Enter answers it, Tab moves between its two ways out, and Escape or Cancel backs out.
Some rows open a level of their own, marked ›: choosing one replaces the list with that row’s choices and puts its name in front of the box as a crumb. Backspace in an empty box goes back a level, clicking the crumb goes back to the list before it, and Escape closes the palette, which opens at the top level next time.
A second Enter while a write is still in flight is ignored rather than sent. A refusal, or a note from a write that landed, is drawn in the palette and the palette stays open; a write with nothing to add closes it. Either way Cmd + Z takes the edit back.
Capture from a terminal
Capture from a terminal
| What differs from a palette capture | Why it matters |
|---|---|
It can carry a date |
The row is on that day’s page, and counts as work owed from the next morning |
| It can carry a note under the line | The palette’s single field has nowhere to put one |
It records captured-by |
The login a reverse proxy supplied, and nothing at all on a direct loopback call |
Either way the new row is marked To do. Cmd + Z does not reach a capture sent from somewhere else: an undo history is this tab’s account of what it did, and nothing was pressed here.
Footnotes
-
The
+on the Outlines heading holds New outline and New document (Typing an outline). ↩ -
The Reference section counts the files beside each folder’s name. Opening a document opens that section and the folders leading to the file, and marks the file’s row; going back to an outline restores the folds you chose. Empty folders are left out, a folder holding both kinds of file appears in both trees, and a directory with only outlines has no Reference heading. ↩
-
The olai section is drawn only when the
_olai/folder has files in it. Those files are part of the directory either way: search finds them, an agent lists them, and git records them. What changes is only whether this list of rows is drawn. An outline olai cannot read shows a ⚠ here, as it does everywhere else. ↩ -
The inbox is an ordinary outline that captured lines land in, and you can type into it. The Inbox badge counts the rows in it marked To do or Doing, at any depth. A row marked done or cancelled leaves the count, a row with no mark was never in it, and the badge is hidden when the count is zero. ↩
-
Alt+←andAlt+→move the focus only when you are not typing: while the caret is in a row they stay the text box’s own word jump, so pressEscapefirst.Alt+ click on a link to a heading inside a document, or on a line of a document’s contents, opens that document at the heading.Cmd+ click, middle-click andShift+ click stay the browser’s own, and open a new browser tab or window. ↩ -
A conversation is a page of its own address, so it opens in a pane and comes back with a reload like any other page (node agents). Open beside › on a chat puts the row or document it is about in the pane next to it.
A click on a link inside a chat’s pane opens in the pane to its left, or in a new one to its right when there is nothing there, so the conversation stays. Below
mdthe panes are a strip of tabs that stays under the header while the page scrolls. ↩ -
In a row’s menu, Pin to sidebar pins that row’s page, and the entry reads Unpin from sidebar once it is pinned. In the palette, Pin this page pins the focused pane’s page in one press, Pin this page… asks what to call a narrowed page first, and Unpin this page takes the focused page off the list. With nothing pinned, the list is not drawn at all. ↩
-
Clicking a pinned narrowed page opens it with that filter in the box, which is how you save a search here; the query is drawn beside the pin’s name. A pinned row shows its title as it reads now; no copy of the title is stored with the pin.
The list of pins is a
Pins.olaiin the directory olai serves. olai creates_olai/Pins.olaithe first time you pin something, and never moves aPins.olaiyou already have. You can edit it like any outline (Documents, references and the kinds olai shows). Reordering and renaming a pin are in the closed block below. ↩ -
A layout pin is offered as Pin this layout…, with the names of the panes underneath, and as Unpin this layout when those pages are already pinned. It always asks for a name:
Enterwith nothing typed says A layout needs a name and keeps the question open, andEscapewrites nothing.A layout pin shows a split mark, and its tooltip lists its pages. Only the pages are saved, so it reopens with the panes equally wide and the first one focused. ↩
-
The other ways to open a tab are the
+at the end of the strip and Open in new tab from a link’s menu.Cmd+Shift+.andCmd+Shift+,move to the next and previous tab, andCmd+Shift+Xcloses the tab in front, as do its×and a middle-click. Right-click a tab for Duplicate tab and Close other tabs, and drag a tab along the strip to reorder it. ↩ -
The tab in front is the one the address bar, the sidebar, Back and every pane gesture act on, while the sidebar and the palette are shared by every tab. A tab opened from a link opens behind the one in front, and closing the last tab leaves one tab on the front page. Back and Forward move within the tab in front, and closing a tab takes its pages out of them. ↩
-
The open tabs are remembered in this browser, so a reload brings them back, though each tab’s Back history starts fresh. A phone has no strip of tabs: Open in new tab shows the page straight away, and the tabs from your desk are kept for when you come back to it (Tabs). ↩
-
A palette you have just opened has nothing chosen, so
Cmd+Kand thenEnterdoes nothing: the first character you type is what chooses, and↓is the other way in. Keyboard shortcuts in the palette lists every key the app answers. What the palette offers on a zoomed row, and how its levels and refusals work, are in the closed block at the foot of this page. ↩ -
A capture moves you nowhere: the page you were reading, your scroll position and the address stay as they were, the line becomes a row, and the box empties for the next line. The palette says afterwards which line landed, and
Cmd+Ztakes a capture back. The Capture to the Inbox row in the palette does the same thing: it types the+and leaves the caret after it. ↩ -
The line lands at the top level of the
Inbox.olaithe directory already has, wherever that file sits, or in a new_olai/Inbox.olaiif there is none. Creating that file is part of the same operation as writing the line, so a capture that is refused leaves no file behind. The Inbox entry in the sidebar opens whichever file that is. ↩ -
olai surface capturesends a line from outside the browser: from a shell, from a Raycast script pointed at Mail.app, or from a cron job that noticed something (Point an agent at a running olai). It writes to the same inbox, and the Inbox entry in the sidebar lights up for it. What it can carry that a palette capture cannot is in the closed block at the foot of this page. ↩