OCTO CREW
Built on the Claude Agent SDK and the Codex SDK

Hire a team of bots that work on your Mac.

Give each bot a name, a role and a folder of its own, then talk to them in DMs, groups and threads. They run on the Claude and ChatGPT subscriptions you already pay for, with no API keys and no server.

Download for Mac View source

Apple silicon, macOS 12 or later. Free and open source under Apache 2.0.

OCTO CREW
# Launch team5 bots

A scripted preview. The main bot splits the work, a thread pulls in another bot with @name, and anything that leaves your Mac waits for your approval.

Connects to the apps you already use, through MCP

Two official SDKs do the heavy lifting

OCTO CREW doesn't reinvent the agent. Claude bots run on the Claude Agent SDK, the same loop behind Claude Code, and ChatGPT bots and images run on the Codex SDK. Both sign in through the logins already on your Mac, so your subscription pays for the work and no API key is stored.

Claude subscription
ChatGPT subscription
Claude Agent SDKagent loop, tools, MCP, permissions
Codex SDKChatGPT models, image generation
Your bots
Its own folder
MCP apps
Routines
Images
Real agents, not a chat wrapper
Every bot gets the SDK's full loop: it plans, calls tools, reads results and keeps going until the job is done.
Your tools, as an MCP server
The app gives each bot its own in-process MCP server for routines, memory, questions and approval cards, next to any apps you connect.
Permission hooks you control
Every tool call passes through a PreToolUse hook in the app. Writes to your accounts are blocked by default, and drafts wait for your approval.
Activity loglive

    What your bots can do

    Two testers hit the same login loop.

    You

    @Fold can you write the error message?

    Fold joined the thread

    Here's a first draft, with a retry button.

    Work as a team

    Your main bot knows everyone's role and hands work to the others. In a thread, anyone can pull another bot in with @name.

    Draft email

    Hi all, the beta opens Friday at 10:00…

    ApproveEditNever

    Ask before it acts

    Messages and emails arrive as editable drafts. Approve once, always or never.

    08:00 dailyMorning briefing
    Every 60 minInbox check
    On pull requestReview and summarize

    Run on a schedule

    Routines fire on a timer, on webhooks, on folder changes or on GitHub pull requests.

    workspaces/octo/
    beta-launch.md new
    feedback.csv
    notes/

    Use your computer

    Each bot gets its own folder to read, write and run things in. What it makes lands in the Library panel.

    Prefers short answersWorks in KSTLaunch is FridayMina writes the emails

    Remember you

    Bots keep a short memory of facts about you that you can edit, or import from another assistant.

    Talk out loud

    Send voice memos or hold a spoken conversation. Speech is transcribed on your Mac.

    OctoClaude Opus GemClaude Sonnet FoldChatGPT via Codex

    Mix models

    Pick any Claude model your plan offers, or a ChatGPT model through Codex, for each bot.

    Everything stays on your Mac

    Conversations, memories and files live in your Library folder, and secrets are encrypted with the macOS Keychain. There is no OCTO CREW server to send them to.

    Install

    1. Install from Terminal. Paste curl -fsSL https://sungmyeonggi.github.io/OCTO-CREW/install.sh | sh. It puts the latest release in Applications and opens it, without the "Apple could not verify" warning.
    2. Or use the disk image. Get the disk image and drag OCTO CREW to Applications. The app isn't notarized yet, so macOS blocks the first launch: open System Settings › Privacy & Security and click Open Anyway.
    3. Sign in to Claude. Install Claude Code and log in, or connect in Settings. Add ChatGPT there too if you want ChatGPT bots and images.
    4. Say hello. Octo is waiting in the sidebar. Press ⌘N to hire another bot.

    Questions

    What does it cost?

    The app is free. Bots use your own Claude subscription (Pro or Max) or an Anthropic API key, and optionally your ChatGPT subscription, so usage counts against those plans.

    Why build on the SDKs instead of calling the API?

    The Claude Agent SDK and the Codex SDK already handle the agent loop, tool calls, MCP servers, permissions and subscription login. OCTO CREW adds the team, threads, routines and the Mac app around them.

    Which Macs does it run on?

    Macs with Apple silicon. Intel Macs, Windows and Linux aren't supported yet, though you can try building from source.

    Is the interface in English?

    Not yet. Labels are in Korean. Bots answer in whatever language you write to them.

    Can a bot send email or post to Slack as me?

    Not by default. "Block writes to my account apps" is on, so bots can only read from apps signed in as you. Turn it off in Settings › Computer if you want drafts you approve to go out.

    How do updates work?

    Every change merged to the main branch is built and published as a new release. The download button on this page always points to the latest one.

    Is this affiliated with Anthropic or OpenAI?

    No. OCTO CREW is an independent open-source project.

    Your team is one download away

    Download for Mac Star on GitHub