Storing Data

Octarine stores your notes as Markdown-formatted plain text files in a workspace. A workspace is a folder on your file system.

Octarine continously watches your workspace folder for an external changes, and makes instant reflection of it in the app. Given that you are working with folder and plain text files, these can be edited by any external text editor of your choosing.

A workspace folder can be created anywhere on your device, including in cloud drives like iCloud, Dropbox local folders.

iCloud Workspaces After Restart

If an iCloud-backed workspace is remembered by Octarine but you can't see your notes in the file tree after restarting your device, iCloud or macOS may not have made the folder readable yet.

This can happen when iCloud Drive is still downloading the workspace, or when macOS privacy permissions temporarily block Octarine from reading the workspace folder and its .octarine metadata.

Try the following:

• Wait a minute for iCloud Drive to finish syncing, then reopen the workspace.
• In Finder, right-click the workspace folder and choose Download Now if it is available.
• On macOS, open System Settings → Privacy & Security → Full Disk Access, add Octarine, and turn it on.
• Fully quit Octarine and open it again.
• If the workspace still looks stale, run Cmd + K → Refresh Workspace to re-index it.

Config File

• Octarine stores major settings in a global .store.dat file and follows a json format.

OS	Path
Mac	~/Library/Application Support/Octarine
Windows	C:\Users\username\AppData\Roaming\Octarine.app
Linux	~/.config/Octarine.app

• These hold information about what workspaces are currently created and at what locations, and their settings — themes, editor, git and more
• These also hold information about your pro license keys, and AI provider keys.

IndexedDB

• Octarine remains fast by loading all data about the workspace into different tables in an indexeddb in the browser engine that powers the app.
• These included folder structure, metadata about notes, pinned/locked notes, ask octarine and writing assistant chats.
• The metadata and files are kept in sync with the local file system to prevent any mismatches.