Write, find, sync

Dropdown and main window

Click the note icon in the bar to open the dropdown. Middle-click it to open the main window. The main window is a normal window, so you can tile it next to your work.

Both show three columns:

• Sources: all notes, pinned notes, notes without a folder, your folders, your tags and the Trash.
• Notes: the notes of the selected source, newest first. Type in the search field to filter them.
• Editor: the selected note, as markdown source, as preview, or both side by side.

The phone button next to the omajot name shows your hub URL as a QR code. In the dropdown, press o to open the selected note in the main window.

App launcher and keyboard shortcut

You can start the main window like an app. This is optional. The plugin does not need it.

Add omajot to the app launcher (SUPER+SPACE). The script is in the plugin folder that omarchy plugin add made:

$ ~/.config/omarchy/plugins/io.github.renerocksai.omajot/tools/install-app.sh

The launcher entry opens the main window. Run the same command with --remove to remove the entry.

To open and close the main window with a key, add this line to ~/.config/hypr/bindings.lua:

o.bind("SUPER + SHIFT + N", "omajot", "omarchy-shell shell toggle io.github.renerocksai.omajot")

The main window is a normal window, so Hyprland tiles it. To open it as a floating window of a fixed size, add a window rule, for example in ~/.config/hypr/looknfeel.lua:

o.window({ class = "^org.quickshell$", title = "^omajot$" }, { float = true, center = true, size = { 1280, 800 } })

Keys

Plugin, outside the editor

Plugin, in the editor

Web app

Editor and preview

You write markdown. The preview shows the result: headings, bold and italic text, lists, tables, code blocks, quotes, links and images. Web addresses become links automatically.

The main window shows the source and the preview side by side. Press e to show only one of them. The setting Editor layout in the main window sets the default.

Titles, checklists and tags

• Title: the first line of a note is its title. A # heading mark is not part of the title.
• Checklist: write - [ ] task. Click the box in the preview to tick it. omajot changes the source for you.
• Tags: write #word anywhere in the text. A tag starts after a space or at the start of a line. Headings (# Title), code and numbers such as #123 are not tags. Tags are not case-sensitive.

Click a tag in the sources column to show all notes with that tag.

Folders, pins and the Trash

• Folders can contain folders. Use the + button next to FOLDERS to add one. To rename, move or delete a folder, hover it in the plugin, or tap ••• in the web app.
• When you delete a folder, its notes move to Notes and its subfolders move up one level.
• Pinned notes show first in every list.
• The Trash keeps deleted notes. Open a note in the Trash and restore it with x.

Paste and attachments

In the plugin, Ctrl+V looks at all formats on the clipboard and takes the best one:

1. An image, for example a screenshot, becomes an attachment.
2. Files copied in a file manager become attachments.
3. Markdown, for example from LibreOffice, stays as it is.
4. HTML, for example from a web page, becomes markdown. Checkboxes become checklist items.
5. Plain text stays as it is.

Images inside pasted text also become attachments. The plugin downloads remote images too, so your notes do not break when a web page changes. The web app keeps remote images as links, because the browser does not allow the download.

Attachments are named by their SHA-256 hash, for example attachments/3f2a….png. The same image is stored once. The hub stores it once for all devices. In the web app, paste an image, drop it, or use the camera button.

Sync and offline

Every device keeps a full copy of your notes. You can read, write and search without a network. omajot sends your changes when the hub is reachable again.

If you change the same note on two devices, omajot merges both changes. There are no conflict copies.

The plugin shows the sync state next to the omajot name, for example Synced or Offline · 3 unsent. The web app shows it at the bottom of the folders column, for example Up to date.

The web app

Open your hub URL on a phone, a tablet or another computer. On a wide screen the web app shows three columns. On a phone it shows one view at a time: folders, notes, or the note.

Install the web app on the desktop too: in Chrome or Edge, use Install app. We test the web app in Chrome and Chromium on the desktop and in Safari on iOS 26. Other modern browsers should work.

Add the web app to the home screen: on an iPhone or iPad, tap Share → Add to Home Screen. The web app then starts offline too. Open it in one tab only: a second tab asks which tab keeps the notes.

The terminal UI

Run omajot tui in a terminal. It shows the folders and tags, the notes and the note, like the main window. Move with j k h l or the arrow keys, search with /, and press e to edit the note in $EDITOR (for example Neovim). Each save goes into the note at once, and changes from your other devices show up while you read. Press ? for all keys. The CLI reference has the details.

Plugin settings

Change the settings in the Omarchy bar settings, or with omarchy bar set io.github.renerocksai.omajot <key> <value>.