gitwtfhub

wtf is cursor-director?

auxten/cursor-director — explained in plain English

Analysis updated 2026-05-18

0Audience · developerComplexity · 4/5Setup · hard

TL;DR

A workflow that turns the Cursor AI editor into a coordinator for multiple command line coding assistants running in parallel, each supervised in its own background terminal session.

Mindmap

mindmap
  root((repo))
    What it does
      Coordinates multiple AI agents
      Runs tasks in tmux sessions
      Reviews evidence before done
    Tech stack
      Cursor
      tmux
      Claude Code and Codex
    Use cases
      Parallel task coordination
      Cross agent review
    Audience
      Developers
      Power users of AI tools

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

Coordinate several AI coding assistants working on different parts of a large task at the same time.

REASON 2

Automatically route work to whichever coding assistant has more usage quota remaining.

REASON 3

Have one coding assistant review another assistant's code changes before marking a task done.

What's in the stack?

CursortmuxClaude CodeCodexGrok

How it stacks up

auxten/cursor-director00kaku/gallery-slider-block04amanrajj/netwatch
Stars00
LanguageJavaScriptRust
Last pushed2021-05-19
MaintenanceDormant
Setup difficultyhardeasymoderate
Complexity4/52/53/5
Audiencedevelopergeneralops devops

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

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Requires tmux plus multiple separately configured CLI coding tools such as Claude Code, Codex, and Grok.

Wtf does this do

Cursor Director is a set of instructions and scripts that turn the Cursor AI coding editor into a coordinator for several other command line coding assistants running at the same time. Instead of doing the actual coding itself, Cursor acts like a project manager: it breaks a task into pieces, decides which AI tool should handle each piece, and reviews the results when they come back. Each piece of work runs inside its own tmux session, which is a way of keeping a terminal program running in the background so you can check on it or reconnect to it later. Every Cursor conversation gets its own separate tmux setup, so several tasks running at once never interfere with each other. A lightweight helper watches each running task, starts the chosen coding tool, feeds it the task instructions, and checks in on its progress every so often, reporting back when it looks finished, without trying to do any of the actual coding or debugging itself. Different coding tools are chosen for different kinds of work. More complex reasoning, architecture, or debugging tasks go to Claude Code, ordinary implementation work goes to either Codex or Grok, and simple repetitive tasks are handled by a cheaper option. The system also tracks how much usage quota each AI provider has left and avoids sending more work to a tool that is close to its limit. Rather than trusting a coding tool's own claim that a task is finished, the system checks the actual file changes, test results, and any other evidence before marking work as done. For apps with a visible interface, such as an iOS app, a task is not considered complete until the feature has actually been built, installed, and tested on a simulator with screenshots to show the result. Finished task sessions are kept around rather than closed immediately, so a person can look back at what happened, and they are only removed when requested or when there is a good reason to clean up. The project also includes a newer approach where two different coding tools review each other's work: one tool's changes are sent to a different tool to check over and either approve or send back for rework, with a limited number of retries.

Yoink these prompts

Prompt 1
Set up Cursor Director in my project so Cursor coordinates Claude Code and Codex CLI running in separate tmux sessions.
Prompt 2
Explain how Cursor Director decides whether a coding assistant's task is actually finished instead of just trusting its self reported success.
Prompt 3
Show me how the pairing feature in Cursor Director sends a diff to a different CLI tool for review before accepting it.
Prompt 4
Walk me through how to reattach to a running tmux session from Cursor Director and take over from the AI mid task.

Frequently asked questions

wtf is cursor-director?

A workflow that turns the Cursor AI editor into a coordinator for multiple command line coding assistants running in parallel, each supervised in its own background terminal session.

How hard is cursor-director to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is cursor-director for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

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