2025-05-22 23:51:27 -04:00
# Todo CLI
2025-05-21 00:35:51 -04:00
2025-05-22 23:51:27 -04:00
A powerful command-line todo application written in Go. Manage your tasks efficiently with a simple, intuitive interface. All data is automatically stored in a SQLite database in your home directory.
2025-05-21 00:35:51 -04:00
## Features
- Add new todos with a title and description
- List all todos, grouped by incomplete and completed
- Mark todos as completed
- Remove todos by ID
2025-05-22 23:51:27 -04:00
- Automatic SQLite database management
- User-friendly command-line interface with intuitive commands
- Data stored securely in user's home directory
2025-05-22 23:15:24 -04:00
2025-05-22 23:51:27 -04:00
## Installation
2025-05-22 23:15:24 -04:00
2025-05-22 23:51:27 -04:00
### Using Go
2025-05-21 00:35:51 -04:00
2025-05-22 23:51:27 -04:00
```bash
go install github.com/AmanTahiliani/todo/cmd/todo@latest
```
2025-05-21 00:35:51 -04:00
2025-05-22 23:51:27 -04:00
### Using Make
2025-05-21 00:35:51 -04:00
2025-05-22 23:51:27 -04:00
```bash
git clone https://github.com/AmanTahiliani/todo.git
cd todo
make install
2025-05-21 00:35:51 -04:00
```
2025-05-22 23:51:27 -04:00
### Using Homebrew (macOS)
2025-05-22 23:25:53 -04:00
2025-05-22 23:51:27 -04:00
```bash
brew tap AmanTahiliani/todo
brew install todo
2025-05-21 00:35:51 -04:00
```
2025-05-22 23:51:27 -04:00
## Usage
2025-05-21 00:35:51 -04:00
2025-05-22 23:51:27 -04:00
### Add a new todo
```bash
todo add -t "Meeting" -d "Team standup at 10AM"
```
2025-05-21 00:35:51 -04:00
2025-05-22 23:51:27 -04:00
### List all todos
```bash
todo list
```
2025-05-22 23:25:53 -04:00
2025-05-22 23:51:27 -04:00
### Mark a todo as completed
```bash
todo complete -i 1
2025-05-21 00:35:51 -04:00
```
2025-05-22 23:51:27 -04:00
### Remove a todo
```bash
todo remove -i 1
2025-05-21 00:35:51 -04:00
```
2025-05-22 23:51:27 -04:00
### Get help
```bash
todo --help
2025-05-22 23:25:53 -04:00
```
2025-05-21 00:35:51 -04:00
2025-05-22 23:51:27 -04:00
## Data Storage
Todos are automatically stored in a SQLite database located at `~/.todo/todos.db` . The application handles all database operations transparently, so you don't need to worry about database management.
## Development
### Prerequisites
- Go 1.21 or later
- Make (optional, for easier building)
### Building from source
```bash
make build
2025-05-22 23:25:53 -04:00
```
2025-05-21 00:35:51 -04:00
2025-05-22 23:51:27 -04:00
### Running tests
```bash
make test
2025-05-21 00:35:51 -04:00
```
2025-05-22 23:51:27 -04:00
## License
MIT License
## Contributing
2025-05-21 00:35:51 -04:00
2025-05-22 23:51:27 -04:00
Contributions are welcome! Please feel free to submit a Pull Request.