gitwtfhub

wtf is subagentmaxxing?

kuberwastaken/subagentmaxxing — explained in plain English

Analysis updated 2026-05-18

5PythonAudience · developerComplexity · 3/5Setup · moderate

TL;DR

A command line tool that lets a Claude Code agent drive OpenAI Codex and Cursor as subagents, just like native Claude subagents.

Mindmap

mindmap
  root((repo))
    What it does
      Runs other AI as subagents
      Fans one prompt to many models
      Normalizes different CLIs
    Tech stack
      Python
      Codex CLI
      Cursor CLI
    Use cases
      Save money on coding tasks
      Get a second AI opinion
      Delegate execution work
    Audience
      Developers
      AI agent builders
    Setup
      git clone and install.sh
      Requires codex and cursor CLIs
      subagent doctor check

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

Let Claude plan a task and hand off the actual coding work to a cheaper model like Grok or Composer.

REASON 2

Send the same prompt to several AI models at once and compare their answers for a second opinion.

REASON 3

Run coding subagents in the background and check on their progress later.

REASON 4

Drive subagents on a remote, more powerful machine over SSH from your laptop.

What's in the stack?

PythonCodex CLICursor CLIClaude Code

How it stacks up

kuberwastaken/subagentmaxxing1ncendium/aibusteraaronmayeux/ha-hurricane-tracker
Stars555
LanguagePythonPythonPython
Setup difficultymoderatemoderateeasy
Complexity3/53/52/5
Audiencedeveloperops devopsgeneral

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Codex CLI, Cursor CLI, or Claude CLI already installed and authenticated on the machine.

The README does not state the license terms.

Wtf does this do

subagentmaxxing lets a Claude Code agent hand off tasks to other AI coding tools, specifically OpenAI's Codex and the Cursor CLI, and treat them the same way it treats its own native subagents. You give it a prompt, pick which model should handle it such as Grok, Composer, or GPT, choose a working folder, and set how much freedom the subagent has to actually make changes, and it hands back one clean answer. You can also send the same prompt to several models at once and compare their answers side by side. The whole tool is a single Python command line program called subagent, with no extra dependencies to install, plus a matching Claude Code skill that teaches an orchestrating agent when to reach for it. The idea behind the project is that Claude is very good at planning and deciding what to do, but running the actual coding work through cheaper models like Cursor's Composer or xAI's Grok can be dramatically less expensive while still getting most of the quality, so pairing a strong planner with cheap workers can save a large amount of money on agentic coding tasks. Setup is a git clone followed by running an install script, which puts the subagent command on your machine and installs the matching skill. A doctor command checks that each backend tool is installed and properly logged in. You can run a single subagent, fan a prompt out across many models at once for a consensus answer, run tasks in the background and check on them later, or even keep the subagents running on a separate, more powerful machine and drive them remotely over SSH from your own laptop.

Yoink these prompts

Prompt 1
Install subagentmaxxing and run subagent doctor to check my Codex and Cursor CLI setup.
Prompt 2
Use subagent fanout to send this prompt to Cursor's Grok, Composer, and Codex at once for consensus.
Prompt 3
Show me how to run a subagent task in the background and check its logs later.
Prompt 4
Explain the cost tradeoff between using Claude directly versus orchestrating cheaper executor models.

Frequently asked questions

wtf is subagentmaxxing?

A command line tool that lets a Claude Code agent drive OpenAI Codex and Cursor as subagents, just like native Claude subagents.

What language is subagentmaxxing written in?

Mainly Python. The stack also includes Python, Codex CLI, Cursor CLI.

What license does subagentmaxxing use?

The README does not state the license terms.

How hard is subagentmaxxing to set up?

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

Who is subagentmaxxing for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

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