For developers · macOS, Windows & Linux

Run AI agents in parallel without losing track

Run Claude Code and Codex across your projects with saved sessions, embedded terminals and Git worktrees — on macOS, Windows and Linux.

Your agents. Your machine.

The same Convoy on every desktop: pick your platform and download the latest release.

macOS

Version 0.6.4 · macOS 14+ · Apple Silicon and Intel · free

Unzip and move Convoy.app to Applications. See the macOS installation instructions below.

Download for macOS

Windows

Version 0.6.4 · x64 · free

Run the setup .exe. The installer is not code-signed yet, so Windows may show a SmartScreen prompt.

Download Windows installer

Linux

Version 0.6.4 · x64 · free

Choose a Debian/Ubuntu package, or make the AppImage executable and run it. Some distributions require FUSE.

Install Git and sign in to Claude Code or Codex CLI before starting. Install GitHub CLI (gh) for pull requests.

Release notes

Inside Convoy

Up to 4 terminals on one screen

A 1, 2 or 4 pane grid with a colour-coded project header. Drag sessions between panes, switch with the keyboard.

Agent status from hooks

Working, waiting for you, done — reported by Claude Code hooks, never guessed from output. Notifications and a Dock badge.

A worktree per task

Isolated checkout and branch for each session; shared .env and node_modules are cloned with APFS.

Tasks → pull requests

Describe a task: the agent takes it in a worktree, verifies, commits and opens the PR. Queue them and auto-review with the other agent.

Docs and specs in the repo

.specdesk/PROJECT.md and specs are read by agents and people alike. AI writes them from the code and works to them.

Files & Changes panel

A JetBrains-style source-control panel beside the terminal (⇧⌘G): stage by checkbox, unified or split diffs with per-hunk discard, commit with an AI-written message, push, pull and open the PR. Files tree, commit log with revert, and a branch switcher — following whichever worktree the agent is in.

History and reviews

Every saved Claude Code and Codex conversation for a folder, resumable in one click. Hand finished work to the other agent for a review brief.

macOS requirements

  • macOS 14 Sonoma or newer
  • Claude Code and/or Codex CLI installed with your own login
  • Git; the gh CLI for automatic pull requests

Install on macOS

curl -fsSL https://peshbar.com/convoy-install.sh | sh
  1. Fastest: one Terminal command downloads, installs and allows the app to open.
  2. Or by hand: unzip the archive and drag Convoy.app into Applications.
  3. If macOS says it could not verify the app, open System Settings → Privacy & Security and click Open Anyway. The app is signed locally, not notarized by Apple.

Convoy collects nothing and sends nothing to our servers. Agents run with your own logins.