rustodo 2.19.0

A modern, powerful task manager built with Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108

<p align="center">
    <img src="https://raw.githubusercontent.com/joaofelipegalvao/rustodo/main/assets/logo.png" width="280">
    <br>
    <a href="https://github.com/joaofelipegalvao/rustodo/releases">
        <img src="https://img.shields.io/github/v/release/joaofelipegalvao/rustodo?style=flat&labelColor=1C2C2E&color=C96329&logo=GitHub&logoColor=white"></a>
    <a href="https://crates.io/crates/rustodo">
        <img src="https://img.shields.io/crates/v/rustodo?style=flat&labelColor=1C2C2E&color=C96329&logo=Rust&logoColor=white"></a>
  <a href="https://codecov.io/gh/joaofelipegalvao/rustodo">
    <img src="https://img.shields.io/codecov/c/gh/joaofelipegalvao/rustodo?style=flat&labelColor=1C2C2E&color=C96329&logo=Codecov&logoColor=white"></a>
    <br>
    <a href="https://github.com/joaofelipegalvao/rustodo/actions/workflows/ci.yml">
        <img src="https://img.shields.io/github/actions/workflow/status/joaofelipegalvao/rustodo/ci.yml?style=flat&labelColor=1C2C2E&color=BEC5C9&logo=GitHub%20Actions&logoColor=BEC5C9&label=ci"></a>
    <a href="https://github.com/joaofelipegalvao/rustodo/actions/workflows/release.yml">
        <img src="https://img.shields.io/github/actions/workflow/status/joaofelipegalvao/rustodo/release.yml?style=flat&labelColor=1C2C2E&color=BEC5C9&logo=GitHub%20Actions&logoColor=BEC5C9&label=release"></a>
    <a href="https://opensource.org/licenses/MIT">
        <img src="https://img.shields.io/badge/License-MIT-BEC5C9?style=flat&labelColor=1C2C2E"></a>
</p>

<h3 align="center">
  A fast, powerful, and colorful task manager for the terminal — built with Rust
</h3>

<p align="center">
  <a href="#-installation">Installation</a> •
  <a href="#-quick-start">Quick Start</a> •
  <a href="GUIDE.md">Documentation</a> •
  <a href="#-contributing">Contributing</a>
</p>

<p align="center">
  <img src="assets/todo-demo.gif" alt="rustodo demo">
</p>

## 📦 Installation

### Via Cargo

```bash
cargo install rustodo
```

### From Source

```bash
git clone https://github.com/joaofelipegalvao/rustodo
cd rustodo
cargo install --path .
```

### Pre-built Binaries

Download the latest binary from the [Releases](https://github.com/joaofelipegalvao/rustodo/releases) page:

| Platform | Binary |
|----------|--------|
| Linux (x86_64) | `todo-linux-amd64` |
| macOS (Apple Silicon) | `todo-darwin-arm64` |
| macOS (Intel) | `todo-darwin-amd64` |

## 🚀 Quick Start

```bash
# Add tasks
todo add "Setup database" --project Backend --priority high --due tomorrow
todo add "Write migrations" --project Backend --depends-on 1
todo add "Weekly review" --due "next monday" --recurrence weekly

# View and filter
todo list
todo list --project Backend --status pending --sort due

# Complete and track
todo done 1
todo stats
```

For the full command reference, see [GUIDE.md](GUIDE.md).

## 🤝 Contributing

Contributions are welcome — bug fixes, new features, documentation improvements, and ideas are all appreciated!

Please read [CONTRIBUTING.md](CONTRIBUTING.md) before submitting a pull request.

```bash
git clone https://github.com/joaofelipegalvao/rustodo
cd rustodo
cargo build
cargo test
```

Found a bug? [Open an issue](https://github.com/joaofelipegalvao/rustodo/issues/new). Have a question? Start a [discussion](https://github.com/joaofelipegalvao/rustodo/discussions).

## Contributors

Thanks goes to these wonderful people ✨

<a href="https://github.com/joaofelipegalvao/rustodo/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=joaofelipegalvao/rustodo" />
</a>

Made with [contrib.rocks](https://contrib.rocks).

## License

Licensed under the [MIT License](./LICENSE).

Copyright © 2026-present, [João Felipe Galvão](https://github.com/joaofelipegalvao)