olai docs
olai serves a directory of outlines and Markdown files as a web app that you and your coding agents edit together. These pages say how to use it. The pitch is at olai.page. New here? Start gets you running on your own notes in about five minutes.
Get started
Install olai, open a folder of your notes in the browser, and keep it running.
Write and organise
Type the rows of an outline, move them, give them dates and to-do marks, and find them again.
Work with agents
Chat with a coding agent, such as Claude Code, beside your notes, and give it work.
Your files and git
What olai keeps on disk, what it refuses to write, and how git records it.
Plugins
Ask an agent for a plugin of your own, or look up the plugins olai comes with. olai is made of plugins running on Cordis (arXiv:2608.25512), and every plugin has a page here.
Server and transport 9
- ws: the live connection between a browser tab and olai
- The MCP endpoint for agents outside olai
- web-app: serving the browser app
- vault: opening the directory olai serves
- settings: reading the settings file
- identity: who is making a request
- The git plugin: commits, pushes and its two settings
- The search plugin: the index and the search box
- vault-plugins: running the plugins your directory defines
Integrations 7
Browser UI 16
- UI renderer: starting the browser app and its named places
- Layout
- Addresses, panes and the command palette
- Tabs
- Sidebar
- Outlines
- Markdown documents: the page and the editor
- The file list in the sidebar
- Pins
- Capture
- Trash
- Alerts
- Preferences
- Theme: colours, typeface and text size
- The Plugins panel
- Link previews
Test fixtures 4
Build olai
How olai is put together, for people working on it. The writing standard these pages are held to is dev/skills/docs-writing/SKILL.md, and packages/tests/docs_lint.test.ts enforces its shape rules per page.
This index is also the site's page map: its ## groups and ### subgroups are the sidebar, and a page it does not list fails the site build.
Roadmap, decisions and root-cause analyses live in the orchestrator's own vault, juspay/oss.olai, under olai/roadmap, olai/brainstorming and olai/RCA.