gitwtfhub

wtf is outerloop?

phyolim/outerloop — explained in plain English

Analysis updated 2026-05-18

3PythonAudience · developerComplexity · 3/5Setup · moderate

TL;DR

Turns your own Mac computers into a small fleet of Claude Code workers managed from one web dashboard for filing and reviewing coding tickets.

Mindmap

mindmap
  root((repo))
    What it does
      Fleet of Claude Code workers
      Ticket to PR workflow
      Web dashboard control
    Tech stack
      Python
      Claude Code CLI
      Homebrew
    Use cases
      File a coding ticket remotely
      Review and approve merges
      Try it in simulated fake mode
    Audience
      Developers
      Mac owners
    Setup
      Install via Homebrew
      Needs claude gh and git
      Pair hub and worker Macs

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

File a coding ticket from your phone and have a home Mac open a pull request for it.

REASON 2

Manage a small fleet of Mac workers running Claude Code from one dashboard.

REASON 3

Review and approve every merge with automated CI checks still enforced.

REASON 4

Try the whole ticket to merge workflow in a simulated fake mode with no setup.

What's in the stack?

PythonClaude CodeHomebrewGitHub CLI

How it stacks up

phyolim/outerloop0marildo/imago0xdfi/glm-5.2-1m-4x-dgx-spark
Stars333
LanguagePythonPythonPython
Setup difficultymoderateeasyhard
Complexity3/52/55/5
Audiencedevelopergeneralresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Real coding work needs Claude Code, GitHub CLI, and git configured on each worker Mac.

No license information is stated in the README.

Wtf does this do

Outerloop turns the Mac computers you already own into a small group of Claude Code workers you manage from a single web dashboard. One always on Mac acts as the hub, holding the ticket queue, scheduler, and dashboard, while any other Mac can join as a worker that picks up tasks. A single Mac can act as a complete setup by itself, since the hub also does its own coding work. The problem it addresses is that the machine capable of doing coding work is often not the one in front of you. Your desk Mac might have Claude Code logged in with repositories cloned and git configured, but if you think of a fix while on your phone, options used to be an awkward remote session or writing the idea down for later. With outerloop you file a ticket from wherever you are, and a capable machine at home picks it up, so you come back later to a finished pull request. The basic unit of work is a ticket. One agent writes code on a branch using the ticket as context, a separate agent reviews that code, and the resulting pull request references the ticket. The reviewer cannot merge its own approval, and even after a human approves a merge, failing automated checks still block it. Machines discover each other on your local network, or connect through an outbound connection to a low cost server when you are away, without a VPN or cloud service. Everything is managed through a web dashboard, with an inbox of things needing your attention, a board listing every ticket, a fleet view of your machines, and a full activity log. As a ticket moves along, an agent may pause to ask a question, or request a tool permission you can allow or deny, and you always get the final say on approving, requesting changes to, or rejecting a pull request before it merges. Installing the menu bar app through Homebrew is the recommended way to start, and it handles setup like the dashboard password and pairing for you. Any Mac doing coding work also needs Claude Code, GitHub's CLI, and git configured with a commit identity. You can also try the workflow without installing real tools, since cloning the repository starts a fake mode that simulates the agents and GitHub end to end using only Python.

Yoink these prompts

Prompt 1
Walk me through installing the outerloop menu-bar app and pairing a worker Mac.
Prompt 2
Explain how a ticket moves from filed to merged in outerloop's review process.
Prompt 3
Show me how to run outerloop in fake mode to try the dashboard without installing tools.
Prompt 4
Help me set up a notify URL so my phone gets pinged on outerloop decisions.

Frequently asked questions

wtf is outerloop?

Turns your own Mac computers into a small fleet of Claude Code workers managed from one web dashboard for filing and reviewing coding tickets.

What language is outerloop written in?

Mainly Python. The stack also includes Python, Claude Code, Homebrew.

What license does outerloop use?

No license information is stated in the README.

How hard is outerloop to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is outerloop for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.