Skip to content
Octopush

Installation

Requirements

Section titled “Requirements”

Octopush is a native macOS application. It ships as a single universal build that runs on both Apple Silicon and Intel Macs — there’s no architecture to choose.

Download

Section titled “Download”

Download Octopush from octopush.sh/download. Open the .dmg, then drag Octopush into your Applications folder.

That link always points at the latest release, so it’s the one to bookmark and share.

First launch

Section titled “First launch”

Double-click Octopush in your Applications folder. It opens straight to the welcome screen.

Every update after that arrives in-app: Octopush checks for new versions, verifies each one against an Ed25519 signature, and installs it in place — you stay current without returning here.

Seeing “Apple could not verify Octopush”? (early-access builds)

While Octopush is in early access, downloaded builds aren’t yet notarized by Apple, so Gatekeeper quarantines the app on first open. It’s a one-time unblock:

  1. Right-click (or Control-click) Octopush in Applications and choose Open, then confirm Open in the dialog.
  2. If there’s no Open option, go to System Settings ▸ Privacy & Security, scroll down, and click Open Anyway next to the Octopush notice.

Alternatively, from Terminal:

Terminal window
xattr -cr /Applications/Octopush.app

You only need to do this once. Subsequent launches — and all in-app updates — open normally.

The welcome screen

Section titled “The welcome screen”

On first run, Octopush greets you with a welcome screen. From here you can open an existing project, drop a folder to open it, create your first workspace — or just describe what you want to build and set a crew on it (no repo required).

[screenshot: Octopush welcome screen]

Add a provider

Section titled “Add a provider”

Octopush is bring-your-own-keys — you connect the models you already pay for. Open Settings (⌘,) and go to Models.

Configure at least one of:

  • Anthropic (Claude) — paste your API key.
  • OpenAI — paste your API key.
  • DeepSeek — paste your API key.
  • Ollama (local) — point Octopush at your local Ollama instance. No API key required.

You can also add any other vendor or gateway: choose the Anthropic or OpenAI-compatible protocol and give it a base URL — no per-vendor setup.

Once a provider is configured, you’re ready to create a workspace.

Next

Section titled “Next”

Continue to Your first workspace.