gtdcleanup(1)

💖 gtdcleanup(1) 💖

okay bestie, so this is the General Commands Manual page for gtdcleanup, and honestly? it's giving life organizer. periodt.

🌸 NAME 🌸

gtdcleanup — Perform a GTD-style cleanup of a todo.txt task file

---

✨ SYNOPSIS ✨

gtdcleanup [-h] <path>

🦋 DESCRIPTION 🦋

okay so picture this: you've got a task file formatted according to the todo.txt specification, and it's a whole mess, and this little program walks in with main character energy and groups all your tasks by project. no cap.

Every project gets its own project header. like, a little sign above the section that says "hey, these belong together." adorable. functional. iconic.

Tasks that are already chillin' in a project section get a + project tag if they don't already have one. so like, we're not double-tagging anybody, we're just making sure nobody's out here untagged and unclaimed 💅.

And if a task has a project tag that doesn't match the project section it's currently sitting in? bestie, it gets moved to the appropriate project section. it's called relocation, it's called growth.

There's also a special _None project section 🫶 — that's the lil corner for tasks where a project just cannot be identified. no project, no problem, they still have a home.

This whole thing is designed to be installable as a todo.txt-base pre or post hook. so you can just let it run automatically and never think about it again. obsessed.

---

🎀 ARGUMENTS 🎀

• <path> — the path to the todo.txt file. just point it at your file, bestie, that's the whole gig.

💅 OPTIONS 💅

• -h, --help — Print help and exit. that's it, that's the option. short, sweet, ate.

---

🌈 SEE ALSO 🌈

• todo.txt-base(8)
• edittodo(8)
• vitodo(8)
• todo.txt(8)
• project(1)
• counttodo(1)

---

a lil heads up, bestie: run all those SEE ALSO friends through man and they'll spill all their own tea 🍓

---

okay that's the whole page, go forth and organize 💖 source: this is from January 2021, and yes it's the gtdcleanup(1) page, we stan a documented classic 👑✨