4 releases (breaking)

Uses new Rust 2024

0.4.0 Aug 11, 2025
0.3.0 Aug 10, 2025
0.2.0 Aug 8, 2025
0.1.0 Aug 8, 2025

#2756 in Command line utilities

GPL-3.0-or-later

39KB
776 lines

作用 (sayo)

status-badge Crates.io Version Crates.io License

A todo.txt CLI for the modern era.

Install

Install using cargo:

cargo install sayo

Uninstall it just as easily:

cargo uninstall sayo

Usage

List all tasks in your todo file with sayo ls:

$ sayo ls
───────────────────────────────────────────────────────────────────────────────────────────────────
  #  ✓  !  Created     Completed   Due         Subject
═══════════════════════════════════════════════════════════════════════════════════════════════════
  1  -  A  -           -           -           Call Mom @Phone +Family
  2  -  A  -           -           -           Schedule annual checkup +Health
  3  -  B  -           -           -           Outline chapter 5 +Novel @Computer
  4  -  C  -           -           -           Add cover sheets @Office +TPSReports
  5  -  -  -           -           -           Plan backyard herb garden @Home
  6  -  -  -           -           -           Pick up milk @GroceryStore
  7  -  -  -           -           -           Research self-publishing services +Novel @Computer
  8  ✓  -  -           -           -           Download Todo.txt mobile app @Phone
───────────────────────────────────────────────────────────────────────────────────────────────────

Add one using sayo add:

$ sayo add "Do my weekly review"
────────────────────────────────────────────────────────────────────────────
  #  ✓  !  Created     Completed   Due         Subject
════════════════════════════════════════════════════════════════════════════
  2  -  -  2025-08-10  -           -           Do my weekly review id:34kb
────────────────────────────────────────────────────────────────────────────

New tasks get a creation date and a small random ID automatically.

Remove a task using sayo remove with the ID given by sayo ls and sayo add:

sayo remove 2

You can use sayo edit to open your task file in your $EDITOR.

sayo edit

Run sayo --help for complete usage instructions.

Maintainer

This project is maintained by Rosa Richter. See her contact page for ways to get in touch.

Contributing

Issues, comments, questions, and pull requests are all welcome. See the contributing guide for details.

License

Copyright © 2025 Rosa Richter

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.

Dependencies

~14–30MB
~425K SLoC