LogoOctarine Docs
Core Concepts

Storing Data

How Octarine interacts and stores data for settings and notes

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.

Config File

  • Octarine stores major settings in a global .store.dat file and follows a json format.
OSPath
Mac~/Library/Application Support/Octarine
WindowsC:\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.

This is never synced with any service (GitSync, iCloud) or never reaches any servers. This is kept completely on device for security purposes.

Please ensure you don’t make any changes or delete this without creating a backup, since deletion could have irreversible changes.

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.

You can refresh a database by using Cmd/Ctrl + K → Refresh Database to force the database to re-index everything.

Note: Ask Octarine and Writing Assistant history as well as Recently Viewed will be wiped clean and can’t be recovered when this is done. Be careful.