project(1)

💖 NAME 💖

project — bestie, this is the lil command that edits one or more of your todo.txt projects ✨ (and yes, it lives in section 1 of the manual, general commands, we love her for that)

---

📜 SYNOPSIS 💅

todo.txt-base [options] [PROJECT ...]

ok real talk, copy that line exactly — it says todo.txt-base, not project, and that's just how she is, iykyk 🫶

---

✨ DESCRIPTION ✨

So here's the vibe: this command goes digging through your todo.txt tasking file and scoops up every task that matches PROJECT 🔍💖 Then it opens up an editor with all those matching tasks sitting right there for you to go feral on. Edit to your heart's content, no cap.

And the best part? Once your edit session is done and dusted, the projects get saved back into the todo.txt file 🌸 Like, it actually commits your chaos for you. Iconic behaviour, honestly.

---

🎀 OPTIONS 🎀

• -h, --help — prints the help and then dips out, exit stage left 💅
• -l, --list — lists all the matching projects and bounces, no editor for you this time ✨
• -f, --file — tell her where your todo.txt file actually lives, since she can't read your mind (yet) 📁
• -x, --exact — requires an exact match to PROJECT — note that by default it's just doing a substring match, so without this flag she's out here matching vibes, not full names 👑 (default: substring, fr fr)

---

🦋 SEE ALSO 🦋

• todo.txt-base(8)
• todo.txt(8)
• gtdcleanup(1)
• counttodo(1)

obviously go read those too, they're the whole friend group 🌈

---

and that's the whole page bestie 💜 this one's from January 2021, source/version-wise, and she's page project(1) — go forth and edit your projects, you absolute main character 🎀✨💖