Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/d4r1us-drk/clido
A powerful CLI todo list & project manager crafted in Go, designed to keep your tasks and projects organized and accessible right from the terminal
https://github.com/d4r1us-drk/clido
cobra-cli go golang project-management task-management task-manager terminal todoapp todolist tui
Last synced: 3 months ago
JSON representation
A powerful CLI todo list & project manager crafted in Go, designed to keep your tasks and projects organized and accessible right from the terminal
- Host: GitHub
- URL: https://github.com/d4r1us-drk/clido
- Owner: d4r1us-drk
- License: gpl-3.0
- Created: 2024-05-25T03:50:42.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2024-09-11T15:31:57.000Z (5 months ago)
- Last Synced: 2024-09-12T00:06:45.854Z (5 months ago)
- Topics: cobra-cli, go, golang, project-management, task-management, task-manager, terminal, todoapp, todolist, tui
- Language: Go
- Homepage:
- Size: 4.64 MB
- Stars: 5
- Watchers: 1
- Forks: 1
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# clido
Clido is an awesome CLI to-do list management application that helps you keep track of your projects and tasks efficiently.
## Table of Contents
1. [About The Project](#about-the-project)
- [Built With](#built-with)
2. [Getting Started](#getting-started)
- [Installation](#installation)
3. [Usage](#usage)
- [Commands](#commands)
4. [Roadmap](#roadmap)
5. [Contributing](#contributing)
6. [License](#license)
## About The Project
Clido is a simple yet powerful CLI tool designed to help you manage your projects and tasks effectively from the terminal. Whether you're a developer, a project manager, or just someone who loves to keep things organized, Clido is the perfect tool for you.
### Built With
- [Go](https://golang.org/)
- [Cobra](https://github.com/spf13/cobra) - For building powerful modern CLI applications
- [SQLite](https://www.sqlite.org/index.html)
- [Tablewriter](https://github.com/olekukonko/tablewriter) - For table formatting in terminal
## Getting Started
To get a local copy up and running, follow these simple steps.
### Installation
You have several options to install Clido:
1. Download the official binary:
- Get the appropriate binary for your operating system and computer architecture from the [releases page](https://github.com/d4r1us-drk/clido/releases).
- Move the binary to a location in your PATH.
2. Install via Go:
```sh
go install github.com/d4r1us-drk/clido@latest
```
3. Install using Make:
```sh
git clone https://github.com/d4r1us-drk/clido.git
cd clido
make install
```
## Usage
Clido allows you to manage projects and tasks with various commands. Below are some usage examples.
### Commands
- Create a new project:
```sh
clido new project -n "New Project" -d "Project Description"
```
- Create a new task with priority:
```sh
clido new task -n "New Task" -d "Task Description" -D "2024-08-15 23:00" -p "Existing Project" -r 1
```
Priority levels: 1 (High), 2 (Medium), 3 (Low), 4 (None)
- Edit an existing project:
```sh
clido edit project 1 -n "Updated Project Name" -d "Updated Description"
```
- Edit a task's priority:
```sh
clido edit task 1 -r 2
```
- List all projects:
```sh
clido list projects
```
- List tasks by project:
```sh
clido list tasks -p "Project Name"
```
- Remove a project:
```sh
clido remove project 1
```
- Toggle task completion:
```sh
clido toggle 1
```
For detailed help, use the help command:
```sh
clido help
```
## Roadmap
- [x] Add task and project management
- [x] Add priority levels for tasks
- [x] Implement Cobra framework for improved CLI structure
- [x] Add shell completion support
- [ ] Add sub-tasks and sub-projects
- [ ] Add a config file with customizable options, like database path, date-time format, etc.
- [ ] Add a JSON output option to facilitate scripting
- [ ] Add reminders and notifications (this would require a daemon)
- [ ] Add a TUI interface
See the [open issues](https://github.com/d4r1us-drk/clido/issues) for a full list of proposed features (and known issues).
## Contributing
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.
1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
## License
Distributed under the GPLv3 License. See `LICENSE` for more information.