Extensions Overview

Extensions add new actions to OctoFlow’s floating toolbar. Each extension defines one or more actions that operate on selected text.

Action Types

OctoFlow supports 8 action types:

Action Type	Description	Example
url	Open a URL with {text} placeholder	Google Search, DeepL
shell	Run a shell command with text as stdin	Word count, formatting
applescript	Execute AppleScript	Send to Notes, Reminders
javascript	Run JavaScript with text as input	Uppercase, Base64 encode
keypress	Simulate keyboard shortcuts	Copy, paste, select all
shortcut	Run a macOS Shortcut	Any Shortcuts app workflow
ai-prompt	Send text to AI with a custom prompt	Summarize, translate
detect	Auto-detect content type and suggest actions	URL detection, email detection

Installing Extensions

Extensions can be installed in three ways:

1. One-click install: Click “Install” on an extension in the Extensions Directory
2. Drag and drop: Drag a .octoclip or .octoext file onto the OctoFlow menu bar icon
3. Manual: Place the extension folder in ~/Library/Application Support/OctoFlow/Extensions/

File Formats

Format	Description
.octoclip	Single-action extension (one JSON file)
.octoext	Multi-action extension bundle (directory with manifest)

Bundled Extensions

OctoFlow ships with several built-in extensions:

• Google Search — Search selected text on Google
• Uppercase / Lowercase — Transform text case
• Summarize — AI-powered text summary
• Word Count — Count words, characters, sentences
• URL Open — Open selected URLs in browser

Tip

Bundled extensions cannot be removed but can be disabled in Settings > Extensions.

Extension Security

All extensions are verified using SHA-256 manifest hashing. OctoFlow checks the signature before running any extension action.

• Signed extensions (from the official directory) show a verified badge
• Unsigned extensions (manually installed) show a warning on first run
• You can review an extension’s source code before granting permission

Building Extensions

Ready to build your own? See the Authoring Extensions guide.