Skip to content
OctoFlow Docs

Installation

System Requirements

  • macOS 15 (Sequoia) or later
  • Apple Silicon (M1+) or Intel Mac
  • Accessibility permission (prompted on first launch)

Download

  1. Download the latest .dmg from octoflow.anotherbug.com/download
  2. Open the DMG and drag OctoFlow to /Applications
  3. Launch OctoFlow from Applications or Spotlight
  4. If macOS blocks the app, follow the Gatekeeper bypass steps below

Gatekeeper Bypass

OctoFlow is not yet signed with an Apple Developer certificate. macOS Gatekeeper will block it on first launch with a dialog like this:

O
”OctoFlow” cannot be opened because the developer cannot be verified.
macOS cannot verify that this app is free from malware.

This is expected — here’s how to open it anyway.

Method 1 — Right-click to Open (recommended)

In Finder, right-click OctoFlow and choose Open at the top of the menu:

◀
▶
Applications
O
OctoFlow
Open
Open With ▶
Move to Trash
Get Info
Rename
Compress “OctoFlow”
Duplicate
Quick Look “OctoFlow”
  1. In Finder, navigate to /Applications
  2. Right-click (or Control-click) OctoFlow
  3. Select Open from the context menu
  4. Click Open again in the confirmation dialog

macOS shows a second confirmation after step 3 — click Open:

O
macOS cannot verify the developer of “OctoFlow”. Are you sure you want to open it?
By opening this app, you will be overriding system security which can expose your computer and personal information to malware that may harm your Mac or compromise your privacy.

You only need to do this once. After the first approval, OctoFlow opens normally.

Method 2 — System Settings

  1. Try to open OctoFlow normally — it will be blocked
  2. Open System Settings → Privacy & Security
  3. Scroll down to the Security section
  4. Click Open Anyway next to the OctoFlow entry
  5. Enter your Mac password if prompted

Here’s what the Security section looks like — the Open Anyway button appears right after the block:

System Settings
SYSTEM PREFERENCES

General

Accessibility

Privacy & Security

Desktop & Dock

Displays

Privacy & Security
Security
Allow apps downloaded from
App Store and identified developers
O
”OctoFlow” was blocked from use because it is not from an identified developer.

Method 3 — Terminal (advanced)

If the above methods don’t work, clear the quarantine flag manually:

Terminal window
xattr -d com.apple.quarantine /Applications/OctoFlow.app

Then open OctoFlow normally.

Accessibility Permission

  1. On first launch, OctoFlow will ask for Accessibility permission.
  2. Click Open System Settings when prompted.
  3. In Privacy & Security > Accessibility, toggle OctoFlow on.
  4. You may need to quit and relaunch OctoFlow after granting permission.

OctoFlow needs Accessibility access to detect text selection in other apps and display the floating toolbar.

AI Actions

OctoFlow works in any app — including Slack. Select any text, and the floating toolbar appears instantly.

Step 1 — Select text and trigger Rewrite

In the example below, a draft message is selected in the Slack compose box. The OctoFlow toolbar appears above the selection with the Rewrite action highlighted.

A
Acme Corp
CHANNELS
# general
# product-team
# engineering
# design
DIRECT MESSAGES
Sarah Chen
Mike Torres
Priya Patel
# product-team👥 12
Sarah Chen 10:42 AM
Hey team! I just finished the competitive analysis for Q3. The main takeaway is that our user onboarding flow needs improvement — we’re seeing a 34% drop-off rate compared to the industry average of 22%.
Mike Torres 10:45 AM
Wow, 34% is rough. Do we know which step in the flow has the biggest drop-off? I bet it’s the payment screen.
Priya Patel 10:47 AM
It’s actually the API key setup step — 60% of drop-offs happen there. I’ve been working on a simplified flow!
our quarterly numbers look decent but honestly the onboarding drop-off is killing us. we lose like 34% of users and competitors are at 22%. we should fix this before the board meeting next week.
BI🔗▶
CopyCutSearch✦ RewriteSummarizeExtensions

Step 2 — Review and accept the rewrite

OctoFlow sends your selected text to the AI model and shows the result in a floating panel. Review the original and rewritten versions side by side, then click Accept & Replace.

A
Acme Corp
CHANNELS
# general
# product-team
# engineering
# design
DIRECT MESSAGES
Sarah Chen
Mike Torres
Priya Patel
# product-team👥 12
Sarah Chen 10:42 AM
Hey team! I just finished the competitive analysis for Q3. The main takeaway is that our user onboarding flow needs improvement — we’re seeing a 34% drop-off rate compared to the industry average of 22%.
Mike Torres 10:45 AM
Wow, 34% is rough. Do we know which step in the flow has the biggest drop-off? I bet it’s the payment screen.
our quarterly numbers look decent but honestly the onboarding drop-off is killing us…
BI▶
✦Rewrite — Professional⚡ Claude 4 Sonnet
ORIGINAL
our quarterly numbers look decent but honestly the onboarding drop-off is killing us. we lose like 34% of users and competitors are at 22%…
REWRITTEN
Our Q3 results are solid, but the onboarding drop-off rate remains a concern — 34% versus the 22% industry average. We need to resolve this before next week’s board meeting. I’ll circulate the proposed Q4 changes to the team by end of day.
Discard↺ Retry✓ Accept & Replace

The rewritten text replaces your selection in place. The whole flow — select, rewrite, accept — takes about 3 seconds.

After launching, OctoFlow lives in your menu bar (top-right of the screen). Click the icon to access settings, extensions, and text expansion preferences.

Updating

OctoFlow checks for updates automatically on launch. You can also check manually via the menu bar icon > Check for Updates.

If you installed via Homebrew:

Terminal window
brew upgrade mousepotato/tap/octoflow

Uninstalling

  1. Quit OctoFlow from the menu bar
  2. Drag OctoFlow from /Applications to the Trash
  3. Optionally remove settings: rm -rf ~/Library/Application\ Support/OctoFlow