Skip to content
Oleaflyv0.4.12

Settings & customization

Choose how you write, connect your research tools, and manage local storage.

Open Settings from the gear in the rail or the command palette, or press ⌘, on macOS or Ctrl+, on Windows and Linux. The shortcut works from the detached PDF window too, and on macOS the Oleafly menu also has Settings…. Settings apply to this computer, unless you turn on cloud sync. A project’s engine, main document, and other project choices travel with its files.

Open Settings from the project toolbar. The left column lists every settings section.
Open Settings from the project toolbar. The left column lists every settings section. Open full screenshot

Type a word into Search settings at the top of the left column, such as “theme”, “Zotero”, or “spelling”. The section list narrows to the sections and settings that match. Pick a setting to jump to it. Oleafly opens the right tab, scrolls to the row, and tints it so you can find it.

General, Appearance, Dictionary, AI Assistant, Engines, Keyboard Shortcuts, and Experimentation each end with Reset to defaults. A small dot on the button means something in that section differs from its default. Resetting one section leaves the others alone.

Paths inside your home folder appear as ~/…. File and folder paths in Settings, such as the projects folder, engine locations, and CLI agent programs, stay blurred until you hover over them or reach them with Tab. A screenshot of Settings then doesn’t show where your files live.

Choose the interface language, set up proofreading, turn offline compilation on or off, and control tours. The interface is available in 21 languages, and System default follows your operating system. A new language applies right away.

Every General control has its own explanation. Offline mode keeps Tectonic and Typst to the packages they already have and turns off network citation lookups. Read Compiling before taking a new project offline.

Choose a light or dark theme, an accent color, a background, and fonts for the app and editor. Any font installed on your computer works. Set the zoom level of the whole app, adjust text sizes, and choose whether projects open in split view, editor only, or PDF only. The editor gets one theme for light mode and one for dark mode, and Editor colors changes any color of either theme. Editor controls here also include line height, letter spacing, the cursor, automatic completion, bracket, math, and environment pairing, sticky context, keybindings (Default, Vim, or Emacs), inline suggestions, and what happens to paths when a file moves. You can also control the file tree, library PDF previews, and Zen mode. The Terminal tab styles the built-in terminal. Its Open folders in setting picks the terminal app for Open in terminal and for commands Oleafly runs for you, such as a CLI agent sign-in. That can be the built-in terminal or another app, such as iTerm on macOS, Windows Terminal on Windows, or GNOME Terminal on Linux. See Appearance & themes.

Review the words you have ignored. The Global tab lists words skipped in every project, and the Projects tab lists words skipped only in the open project. Remove a word to include it in proofreading again. Below the tabs are grammar rules you turned off, dismissed findings, and Rules the academic profile keeps off: every rule with what it does, an example, and a switch to turn it on. See Spelling & grammar.

See where your library lives and how much space projects, files, Git history, and build caches use. Control automatic checkpoints and their storage notices under Local store. The Cloud sync tab backs up your library projects and settings to Dropbox. Manage local storage here and follow Where your data lives when making a backup.

TabWhat you can set up
Providers and keysCloud providers, compatible endpoints, local models, the model picker, project approvals, and budgets.
CLI agentsInstall, connect, and configure agents that run on your computer.
InstructionsWriting instructions, model defaults, PDF capture, and the tool catalog.
PersonasNamed instruction presets for different kinds of work.
SkillsResearch workflows, domain guidance, and your own reusable skills, with a search box and one switch per skill.
MCPExternal tools the assistant can use, including server discovery and configuration import.
ToolsThe model for Tools, such as a local model or a connected CLI agent, and your Mathpix keys.

Start with Set up AI. Read CLI agents, Skills, and Usage & budgets for the individual controls.

Manage the tools that compile your documents. For LaTeX, Oleafly can detect a system TeX installation or install its own TinyTeX. Package management and tagged PDF setup live here. See LaTeX engines & packages.

Manage TeX distributions on the LaTeX tab lists every TeX installation Oleafly found, such as MacTeX, TeX Live, MiKTeX, or TinyTeX. Each row shows a latexmk or tlmgr badge when the installation has that tool, and In use marks the one latexmk compiles run from. To compile with a different one, choose Use for compiles on its row. Automatic on that row hands the choice back to Oleafly, which picks a full system TeX first and TinyTeX after it. A MiKTeX without Perl shows latexmk needs Perl and can’t be picked until you install Perl, such as Strawberry Perl. If TeX is installed in a folder Oleafly doesn’t look in, Choose a TeX folder lets you pick it. See latexmk and system TeX.

Without Oleafly’s own TinyTeX, a TinyTeX card offers Download TinyTeX (~250 MB). The button shows progress while TinyTeX downloads, unpacks, and adds its packages, and Cancel stops the install during the download and unpacking. If a download stops partway, the button reads Resume download with the megabytes already saved and picks up from there. If a full TeX installation is already In use, it stays in use after the install, and so does one you picked with Use for compiles. Choose Use for compiles on TinyTeX to switch. A full installation has latexmk, pdfLaTeX, XeLaTeX, LuaLaTeX, and Biber. In Automatic, Oleafly ranks an installation missing some of these, or a MiKTeX without Perl, behind TinyTeX, so TinyTeX takes over by itself once it’s installed. Once installed, TinyTeX has its own row with Remove. The row also shows Update when your TinyTeX isn’t the release this version of Oleafly expects.

On Debian, Ubuntu, and Fedora, a TeX Live installed from the system’s packages belongs to apt or dnf. The package list says so, and Oleafly leaves that TeX Live alone. Add packages with the system tool, or download TinyTeX if you want Oleafly to manage them.

The LaTeX tab also holds Default compile engine. New, imported, and converted LaTeX projects start on the engine you pick there. See Set a default for new projects.

For Typst, Versions lists Typst 0.11 to 0.15. Install a version, choose the default for new projects, and use Try a newer version to build the open project with a newer Typst and see which errors and warnings would change before you switch. Each project pins its own version from the Compile menu. See Typst versions.

The Markdown compiler row installs or repairs the managed Pandoc.

Download template and font packs, add a downloaded font to a project, review downloaded spelling dictionaries, and manage AI templates saved to your gallery. The Sources tab sets where downloads come from and which repository tlmgr installs TeX packages from. See Downloads.

Each tab shows the service’s own logo.

TabWhat it connects
GitHubYour account for publishing, pulling, and pushing projects, and whether new projects get a Git repository.
alphaXivalphaXiv’s MCP server, so the assistant can search and read papers.
ZoteroYour Zotero library, to cite from while you write or to import into a project’s bibliography.
Citation SearchKeys and a contact email for scholarly search services.
Oleafly MCPOleafly’s local server for an external assistant to work with your project.
Desktop appsCua Driver, so an agent can use the desktop programs and websites you allow.

Connect research sources covers alphaXiv, Zotero, and Citation Search. An external MCP tool connects under AI Assistant → MCP. An external assistant connects to Oleafly through Integrations → Oleafly MCP. The MCP guide covers both directions.

Search the shortcut list and record replacements for the app actions that support customization. Editor bindings are listed alongside app commands. See Keyboard shortcuts.

Experimentation holds features that are still in beta. A warning at the top of the section says these features aren’t fully tested yet and may change, break, or be removed in a future release. Each switch is off by default:

  • LaTeX tools shows the Oleafly Tools gallery and its slash commands. The Oleafly Tools guide covers every converter, reference builder, research utility, checker, and writing helper.
  • Notes adds Notes to the Home dock. A note is a Markdown file with diagrams, charts, and math that you and your agents can both edit. Notes stay out of your project library, and you can link each note to a project. The switch also adds a Notes tab to Settings → Appearance and to Settings → Keyboard Shortcuts. See Notes.
  • Research tasks lets an agent work on its own in a copy of a project and leave its changes for you to review. The app marks it as highly unstable: runs can stall, fail, or leave changes to sort out by hand, and they use your provider’s quota the whole time. Turning it on adds a Research section to Settings, and turning it off stops every running task. See Research tasks.
Settings → Experimentation with LaTeX tools, Notes and Research tasks turned on, below the warning that these features are still in beta.
Settings → Experimentation with LaTeX tools, Notes and Research tasks turned on, below the warning that these features are still in beta. Open full screenshot

Turn a switch on here before following a guide that uses it.

Check the app version, look for updates, read What’s new, restart a tour, open documentation, or report a problem. Copy Info gathers version and system details for a bug report. Cite Oleafly in your paper is the last card on the page.

Five small buttons sit at the bottom of the Settings sidebar, whichever section is open: Discord, X, GitHub, the documentation, and release notes. The last one opens What’s new.

Read the individual guides for General, Appearance, Downloads, Storage, and Help.

Image preview

AI answers couldn’t load

Try again, or search the documentation.