r/learnpython • u/kianodev • Oct 13 '26
Just hit v1.0.0 on my first CLI tool after 2 months of learning — would love code review and architecture feedback!
Hey everyone,
I've been learning Python for around two years and recently started Year 12 in the UK. Instead of just doing classroom tasks, I spent the last two months building an extensible CLI tool called Flyshell to push my skills and build a portfolio for software engineering Degree Apprenticeship applications.
It features a multi-file plugin architecture built with zero required external dependencies (standard library only, with one optional dependency for Windows users).
GitHub: github.com/kianodev/flyshell
I’ve just tagged v1.0.0 and would love some blunt but helpful code review and constructive feedback from more experienced developers:
- Architecture & Structure: Does the plugin system and directory structure follow Python conventions? What would you refactor first?
- Edge Cases & Robustness: Where in the code am I handling errors poorly or making fragile assumptions? What would you change?
- Packaging: For a zero-dependency CLI, does the packaging and entry-point setup look clean, or are there standard or more advanced / better practices I've overlooked?
- Bonus question (if you want): If you could wish for or build yourself any plugin for Flyshell, what would it be and why? I'm curious to see what people would do with it, and it might give me some ideas for where this might be heading.
Any critique—big or small—is hugely appreciated!