Organizing your Python scripts

Python is an awesome language, and it makes it highly convenient to write (simple) scripts to manage some specific tasks. The problem is that those scripts are often scattered across the system, hard to find, and use.

So I decided to write a simple CLI app to organize my scripts, making them easier to find and more convenient to use. I chose Typer and Textual for this project. Unfortunately, I’m not familiar with those excellent libraries, so I decided to use Claude's code to build the app's skeleton, which is available on GitHub.

The help screen

I started creating a CALUDE.md file with all the requirements and specifications for the app, then asked the Agent for an implementation plan.

In my case, working in small steps, testing and checking them, worked fine and allowed me to fix the path while building. The Agent generates code quickly — sometimes too quickly — and you must step in to organize it into a better, more reusable/maintainable form.

Overall, the process has been quick and smooth (I worked on it in a few sessions in my spare time), and the result seems satisfying. It’s extremely easy to add new groups and commands, add the documentation, and create shortcuts (aliases) for my system.

The app contains just the skeleton with some dummy examples to illustrate how to use it in practice, but you can add as many commands as you like in an easy, organized, and manageable way. The app autodiscovers new commands as soon as you add them.

I also added a toy TODO app, mainly to display notifications on the screen while working (a kind of easy-to-use reminders), but it’s pluggable, and you can easily add more advanced features. To manage Date and Time pickers, I tried a new package, textual-timepiece, which is very promising but still in alpha, so I switched to the dialog feature on my Linux box. I added pluggable features such as a file browser to locate the directory you want to work with (which uses Yazi, Midnight Commander, Ranger, or LF, if installed) and a copy feature that allows you to copy the result to the clipboard (using xclip, xsel, or wl-clipboard on Linux, pbcopy on Mac, clip on Windows, and falls back to pyperlcip, to be installed manually, if none is available).

The complete documentation is available on GitHub Pages. I hope you like it and find it as helpful as I do.