Folra plugins

Install a .folraplug package in Folra, or use the development guide to build your own plugin.

Official plugins

View GitHub releases

Build a plugin

A plugin starts with a JSON manifest and a JavaScript command. Build it with Folra’s CLI or give the development guide to your coding agent.

Selection or document
Choose the text your command receives. Check a document, clean up a selection or generate a template.
Native parameters
Set plugin options with text fields, dropdowns, and toggles when you run a command.
Text and edits
Copy or insert text returned by a plugin, or preview proposed edits before applying them.

Workspace tools and editor extensions

These capabilities require Folra 0.1.16 or later and Plugin API 4. Plugin scripts run in a sandbox.

Notes, images, and OCR
Request access to Markdown notes and images in the workspace, recognize text in images on your Mac, and propose file changes for review.
Native tools and shortcuts
Add a native sidebar or tool window, keyboard shortcuts, completions, or rendering for custom code blocks.
Network requests
Plugins declare which HTTPS hosts they use. Folra shows the destination and request details and asks before sending each request.

Unzip and install the example using the steps below. Select a few plain-text lines and run Plain text tools from the Plugins menu to sort them, remove duplicates or add a prefix.

Get started with the CLI

These commands use Folra in Applications. The scaffold includes a working command and test cases you can edit. Run the tests again after changing the command, then package it to a new folder.

folra="/Applications/Folra.app/Contents/MacOS/Folra"
"$folra" plugin scaffold ./MyPlugin --api 2 \
  --id com.example.my-plugin --name "My Plugin" --scope selection
"$folra" plugin validate ./MyPlugin
"$folra" plugin test ./MyPlugin
"$folra" plugin pack ./MyPlugin ./MyPlugin.folraplug

Install a plugin

Local installation requires Folra 0.1.15 or later. Check the plugin’s minimum version before installing.

  1. Unzip a downloaded ZIP or use the .folraplug folder you built.
  2. In Folra, choose Plugins → Manage Plugins… → Install Plugin… and select the .folraplug folder.
  3. Open a Markdown document and run the plugin from the Plugins menu.