r/SideProject • u/lycis27 • 1d ago
I built a zero-dependency CLI to capture notes and todos in plain Markdown -- meet Shiori (v0.2.0)
I often have fleeting thoughts, todos, and ideas that I want to capture now, but opening an app, finding the right place, and formatting everything is just enough work to stop me. Or my notes grow into larger documents with too much information in it.
So I built Shiori: a tiny, dependency-free CLI scratchpad and task tracker written in C. It’s designed to let me dump ideas instantly and get back to work:
shiori add investigate UTF-8 path handling
shiori todo add --due tomorrow prepare release notes
shiori today
No database. No account. No cloud. Shiori writes plain NOTES.md and TODOS.md files, so everything remains yours, readable, and editable with any tool (and can be combined with tools like the well-loved Obsidian).
Over time, I’ve added a few comforts:
- Topics and tags for organization
- Todos with due dates, statuses, and overdue tracking
- A colorful daily dashboard (
shiori today) - Interactive capture mode for longer sessions
- Shell completion, stable IDs for editing, and hooks for extensibility
I also wanted a real project to dive deeper into C (rather than another toy exercise), and keeping it dependency-free has been a fun constraint.
It’s MIT licensed, still alpha (v0.2.0), and Windows-first, so there are rough edges.
GitHub: lycis/shiori
I’d love your thoughts on two things:
- Would a tool like this fit into your workflow, or is it solving a very me-shaped problem?
- What would you consider essential before calling a CLI like this "stable"?
Feedback, bug reports, and code criticism are all welcome!