[go: up one dir, main page]

olai

a git-native outliner

olai

An outliner that lives in files you own.

Indent, check off, search. Markdown sits beside the outline. Git records every edit.

nix run github:juspay/olai -- web path/to/outlines

one directory. a browser. that’s the whole install.

Start in five minutes Read the docs

A palm leaf drawn in ink on sea-glass paper, coral at the tips.
kitchen.olai
●Kitchen renovation 2/4
Demolition
Pick the counter stone
Order the new cabinets #blocking5 days late
Book the plumber
●Paint samples on the north wall

Compared to Workflowy and Dynalist

Same outlining model — indent, move, mirror, check off. The difference is where the data lives.

Workflowy, Dynalistolai
StorageA hosted databasePlain files in a directory you choose
SyncTheir cloudgit, or anything that moves files
HistoryIn-app version historygit log
SearchKeyword, in their appFilter the page you’re on, or search the whole directory
SourceProprietaryOpen source (AGPL-3.0)

Outlines are ordinary files. The format spec is there if you want it.

What’s due

Dated work from every outline, on one page. Late things sit above today. A birthday isn’t a task — it stays on its day and never turns red. The calendar is a plugin.

/agenda · 2026-08-12

5 days ago · Fri, Aug 7

Order the new cabinets #blocking5 days late

Kitchen renovation

Today · Wed, Aug 12

Book the plumber

Kitchen renovation

Sat, Aug 15in 3 days

Template the countertop

Kitchen renovation

two quiet weeks

Fri, Aug 28in 2 weeks

Meet the tiler on site14:00

Kitchen renovation

A file named for the day — 2026-08-12.md, anywhere in the directory — is that day’s note. Open the day and the note is on top, with everything dated that day underneath it.

Weekly chores come back as a fresh row on the next date, so eleven Mondays are eleven rows, not one row whose date kept moving.

Filter the page you are on

Type in the box above the outline and the rows that don’t match are hidden. Clicking a tag does the same. The query is in the page’s address, so you can send the filtered page to someone as a link.

/house.olai?q=%23home+OR+alcove
●kitchen remodel #home
●order the new cabinets
…measure the alcove before ordering.
●install the cabinets
pick the hinges #home

Matches stay where they live. Ancestors stay so a bare title still makes sense.

Done, last week, a quoted phrase — the rest of the query language is in the search docs.

Type like an outliner

Click a title to edit it in place. Enter makes the next line. Tab indents. The rest is the usual outliner muscle memory.

Entercommit, and open the next line
Enter mid-linesplit the row in two, there
Backspace at the startjoin this row onto the one above
Tab / Shift+Tabindent, or out again
Alt+Shift+↑/↓move a row among its siblings
⌘+Ztake back your last edit here
⌘+Entertick it off, or take that back
⌘+⇧+Enterwalk the mark on: to do, then doing, then none
⌘+⇧+Dduplicate the row, and everything under it
⌘+⇧+Mmove it under a row you search for, anywhere
Shift+Enterwrite the note under it
Escdrop what you were typing

Off a Mac, ⌘ is Ctrl. The full map — dragging, the palette, pins, the inbox — is in the editing docs.

How it looks

Four palettes — two by day, two by night — and an unpicked page follows your OS. Press a chip; this page follows.

chalkreefbasaltabyss
kitchen.olai · basalt
●Kitchen renovation 2/4
Demolition
Order the new cabinets #blocking2026-08-07
Book the plumber
kitchen.olai · reef
●Kitchen renovation 2/4
Demolition
Order the new cabinets #blocking2026-08-07
Book the plumber

A coding agent edits your outlines with you

A chat opens on the row it is about, beside that row’s page. You keep typing while it works. It ticks off tasks and rewrites Markdown files, and you watch the page change. Git records both of you.

chat
◦Book the plumber
plumber's booked — tick it off
✓ marked done · Book the plumber
✓Book the plumberDone
kitchen.olai
Done. Marked “Book the plumber” as done.
the base units are carcass-only — say so in the doc
✓ cabinets.md

cabinets.md+3−2

1 # Cabinet specs
⋯ 3 unchanged
6-- 600 mm base × 4
6+- 600 mm base × 4, carcass only
7+- filler strip × 2
8 - corner carousel × 1

+4 more lines

Added the carcass note and the filler strips.
kitchen.olai · live
●Kitchen renovation 3/4
Order the new cabinets #blocking
Book the plumber

The page updates because the file on disk changed.

How to point an agent at a running olai is in the chat docs.

Plugins

The outline editor, the Markdown reader, the shell, chat, git, search — they are plugins. They show on one panel. Switch one off while olai is running; the rest keep going. The runtime is Cordis, a meta-framework of spatiotemporal composability. The paper is on arXiv.

▶Needs attention1
▶MailNeeds setup
No Gmail account connected.
▶Agents4 on · 2 off
▶Chat
▶Claude Code
▶Codex
▶OpenCode
▶Pi
▶Oh My Pi
▶Notes19 on
▶Connections6 on · 1 off
▶Interface10 on
▶Your plugins2 on
▶Hex swatch
▶Morning agenda
▶Serverlaptop

Ask for one. Press ⌘K, say in one sentence what it should do, and an agent writes it while you watch.1 Read what it does, press Turn on, and it starts drawing in the page you are on. No reload, no install, no build.2 Your settings travel with your notes.3

my-notes/
├── plugins/
│   └── hex-swatch/
│       ├── README.md     what it does, for people
│       ├── server.ts     what runs on the server
│       └── browser.tsx   what draws in the page
├── _olai/
│   └── Settings.olai     hex-swatch: on, approved
├── colours.olai
└── kitchen.olai
Every plugin olai ships, and what each one does

Server and transport

wsThe connection your browser tab uses to talk to the olai server.
mcpThe MCP server that coding agents connect to for olai's tools, how long it runs, and its session tickets.
web-appServes the browser app's files, separately from the browser connection and the MCP server.
vaultThe directory olai serves: the one path every write goes through, the lock that keeps a second olai out, and the format settings.
settingsSettings for the whole directory, read from one Settings.olai file.
identityWho is looking at the page: which request headers olai trusts, and the captured-by chip.
gitRecords commits, and holds the commit and push settings.
searchMatches search queries, and what still works when search is switched off.
vault-pluginsThe plugins a directory keeps in its own plugins/ folder: reading them, approving them, and their pages.

Integrations

chatHow a conversation is stored as a row, the chat-agent-session property, and the services chat offers other plugins.
koluTerminals from kolu: a terminal's row, a live view of it, the feed of terminals waiting on you, and messages to a conversation.
browsingA Chromium browser you and your agents share: the page that shows it, shared sign-ins, who owns it, settings and safety.
oduCI runs from odu: a chip on the row naming the run, a grid of its jobs, and messages to a conversation about runs.
xyne-spacesCopies the messages plugins post into a conversation to a Xyne Spaces channel.
mailGmail: connecting an account, reading and filing mail from a conversation, and acting on threads.
journalThe calendar, a page for each day, and the agenda of rows that have a date.

Browser UI

ui-rendererDraws the browser app with Solid, and lets plugins add parts to named places on the page.
layoutThe page's frame: the sidebar column, the header and its health dot, banners, and the places where file viewers sit.
navigationPage addresses, Back and Forward, which pane has focus, and the command palette.
tabsSeveral pages open as tabs above the panes, each with its own Back and Forward.
sidebarThe column of files on the left, the narrow rail beside it, and the places plugins can add to them.
outlinesOutline pages: editing a row, and the commands on a row's menu.
markdownEditing Markdown documents, their front matter, and headings.
filesBrowsing the files in the directory, and creating new files from the browser.
pinsThe pinned pages in the sidebar: their order, and the commands to pin and unpin.
captureQuick capture: typing a row straight into the inbox, and the palette's prefix for it.
trashBrowsing rows you threw away, restoring them, and emptying the Trash.
alertsDesktop notifications: asking for permission, the sound, and the mark on the browser tab.
preferencesThe Preferences panel: what it holds, and how far each choice reaches.
themeColours, typeface and text size, stored per browser and set under Appearance.
plugin-inspectorThe Plugins panel: switching plugins on and off, why one failed to start, and trying again.
link-previewRead-only previews, kept up to date, of the pages that links inside olai point to.

File kinds

outline-olaiWhich files are outlines (.olai), how they are read, and the one way olai writes them.
hypertextShowing saved .html pages in a locked-down preview.
csvShowing a .csv file as a table, read-only, with its first row as the headings.
hledgerShowing hledger accounting journals as transactions, balances and source.
imageShowing pictures, and serving the image file to the browser.
pdfShowing a .pdf file in your browser's own PDF viewer, read-only.

Test fixtures

test-layoutA replacement page frame built only from the public navigation parts.
test-counterA tiny plugin showing that olai runs with no directory served at all.
test-paletteAdds entries to the command palette through the public interface.
test-pageAdds a page that the plugin draws itself.

Git records your edits

Every edit is written to disk at once. Commit from the panel when you are ready, or turn on Auto-commit and olai makes one commit after fifteen quiet seconds.

┌─ Changes ─────────────────────────────────┐
│ olai: Outlines as a collection done       │
│   · chat agent · 12m ago · 1a2b3c4        │
│                                           │
│ OUTLINES ─────────────────────────────    │
│ ☑ roadmap.olai                            │
│   ✓  Outlines as a collection    done     │
│   ✎  Notes: one state, same line  note    │
│   +  Kolu integration: auto-…    created  │
│                                           │
│ OTHER FILES ──────────────────────────    │
│ ☑ README.md                    modified   │
│ ☐ notes/scratch.md            untracked   │
│                                           │
│ 2 commits not on origin/master   [ Push ] │
│         [ Commit 3 changes · 1 file ]     │
└───────────────────────────────────────────┘

Commit messages start with olai, so the trail is easy to find. The rest is in the git docs.

Footnotes

  1. The worked example is a morning agenda: from 7 in the morning it sends the rows that are overdue or due today into each node agent's conversation, once a day. Read the morning agenda. ↩

  2. What you are left with is a folder in your own directory: a README anybody can read, and the code. Git records every line of it. Copy the folder into another directory and it arrives switched off, until a person there turns it on. ↩

  3. A plugin you asked for keeps its settings in the same file as the plugins olai ships. A top-level row in _olai/Settings.olai names each plugin; its properties choose how it behaves and whether it runs. The Plugins panel writes the same file. See the settings docs. ↩