Installation

Requirements

Octopush is a native macOS application. It ships as a universal build that runs on both Apple Silicon and Intel Macs.

Note

Octopush is macOS only. There is no Windows or Linux build.

Download

Grab the latest .dmg from the releases page. Open the disk image and drag Octopush into your Applications folder.

First launch and Gatekeeper

The first time you open Octopush, macOS Gatekeeper may warn you that the app is from an unidentified developer. This is expected during early access.

To authorize it:

1. Right-click (or Control-click) the Octopush app in Applications.
2. Choose Open from the context menu.
3. Confirm Open in the dialog.

If you don’t see an Open option, go to System Settings ▸ Privacy & Security, scroll down, and click Open Anyway next to the Octopush notice.

[screenshot: Gatekeeper “Open Anyway” button in System Settings ▸ Privacy & Security]

You only need to do this once. Subsequent launches open normally.

The welcome screen

On first run, Octopush greets you with a welcome screen. From here you can open an existing project or create your first workspace.

[screenshot: Octopush welcome screen]

Add a provider

Octopush brings your own keys — you connect the models you already pay for. Open Settings (⌘,) and go to Integrations.

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.

Tip

If you want to run entirely locally with no cloud cost, install Ollama and select it as your provider. Everything else works the same.

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

Next

Continue to Your first workspace.