gitwtfhub

wtf is task-folder-router-for-codex?

webloti/task-folder-router-for-codex — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 2/5LicenseSetup · easy

TL;DR

A template that automatically routes labeled Codex AI coding tasks into their own isolated subfolders inside a shared workspace.

Mindmap

mindmap
  root((Task Folder Router))
    What it does
      Label based routing
      Folder creation
      Session state tracking
    Tech stack
      Python
      JSON
    Use cases
      Multi project workspaces
      Client task isolation
      Continued subtasks
    Audience
      Codex users
      Developers

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

Automatically route labeled Codex tasks like client: acme into their own isolated project subfolder

REASON 2

Keep unrelated Codex tasks from writing files into the same shared workspace root

REASON 3

Continue the same subproject across multiple separate Codex tasks using a shared folder label

REASON 4

Check whether a Codex workspace's router installation is set up correctly without changing files

What's in the stack?

PythonJSON

How it stacks up

webloti/task-folder-router-for-codex0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultyeasymoderatemoderate
Complexity2/52/54/5
Audiencedevelopergeneraldeveloper

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

How do you spin it up?

Difficulty · easy Time to first run · 30min

Needs Python 3.8 or newer and a Codex workspace that allows project hooks.

Free to use, modify, and distribute, including commercially, as long as the MIT copyright notice is kept.

Wtf does this do

Task Folder Router for Codex is a small template that helps keep the AI coding assistant Codex organized when it is used for many unrelated tasks inside a single workspace. Without it, every task Codex runs tends to write files into the same root folder, which can quickly get messy once you are juggling several different projects or clients at once. This tool watches for a label at the start of a new Codex task, such as project, client, site, or app, followed by a name, and automatically creates or reuses a matching subfolder for that task to work inside. By default the router runs in a mixed mode: tasks that do not start with a recognized label continue to work in the main workspace root exactly as before, while labeled tasks get routed into their own isolated subfolder, such as clients acme inc or projects my dashboard. Names are automatically converted into safe folder names, and only labels you have explicitly configured are accepted, so the tool cannot be tricked into creating arbitrary folders from unexpected input. The project is explicit about its limits: it does not read the contents of your projects, does not send any data anywhere, and does not commit, push, deploy, or install anything on its own. Installation involves cloning the template once into a separate tools folder and then running a Python installer script against each individual Codex workspace where you want the router active, which asks you which labels you want to allow. Once installed, the workspace contains a small hooks file and a router configuration file that tell Codex which folder to use for each new task. A companion doctor script lets you check whether a workspace's setup is correct without changing anything. The project requires Python 3.8 or newer and a Codex setup that supports project hooks. It is released under the MIT license.

Yoink these prompts

Prompt 1
Install task-folder-router-for-codex into my Codex workspace using the Python installer script
Prompt 2
Explain how the project-continue label reuses an existing task folder instead of creating a new one
Prompt 3
Show me how to add a new custom label like site: to my router configuration
Prompt 4
Run the doctor script to check my Codex workspace's router setup

Frequently asked questions

wtf is task-folder-router-for-codex?

A template that automatically routes labeled Codex AI coding tasks into their own isolated subfolders inside a shared workspace.

What language is task-folder-router-for-codex written in?

Mainly Python. The stack also includes Python, JSON.

What license does task-folder-router-for-codex use?

Free to use, modify, and distribute, including commercially, as long as the MIT copyright notice is kept.

How hard is task-folder-router-for-codex to set up?

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

Who is task-folder-router-for-codex for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

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