LinuxCommandLibrary

clido

Execute command-line instructions using natural language

TLDR

Create a list

$ clido --new [name]
copy

Load a list
$ clido --load [name]
copy

Delete a list
$ clido --remove [name]
copy

List all lists
$ clido --lists
copy

Toggle autowrite
$ clido toggle-autowrite
copy

Open a list in a text editor
$ clido edit [text_editor]
copy

Display help
$ clido -h
copy

Display version
$ clido -v
copy

SYNOPSIS

clido [SUBCOMMAND]

PARAMETERS

add <TEXT>
    Add a new todo item with optional priority and tags

ls [--all | --done]
    List todos; --all shows done, --done shows only completed

done <ID>
    Mark todo by ID as done

rm <ID>
    Remove todo by ID

edit <ID> [<TEXT>]
    Edit todo by ID, optionally with new text

-h, --help
    Print help information

-V, --version
    Print version information

DESCRIPTION

Clido is a lightweight, blazing-fast command-line todo list application written in Rust. It provides a simple interface for managing personal tasks without the overhead of complex tools like Taskwarrior. Todos are stored in a single TOML file at ~/.local/share/clido/todo.toml, making it easy to backup, sync, or version control with Git.

Key features include adding tasks with priorities and tags, listing items sorted by priority or date, marking as done, editing, and removing entries. It supports natural language priorities (high, medium, low) and custom tags for categorization. Clido emphasizes speed and minimalism, with no dependencies beyond Rust's standard library for core functionality.

Ideal for users who want a distraction-free todo system directly in the terminal. It integrates well into shell scripts or aliases for workflows like clido ls | grep urgent. While lacking advanced features like recurring tasks or due dates, its simplicity ensures reliability across Linux distributions.

CAVEATS

Todos stored in single file; no due dates, projects, or recurrence. IDs are 1-based indices that shift on deletions.

TODO FORMAT

Each entry: id = 1, text = "Buy milk", priority = "high", tags = ["groceries"], done = false

INSTALLATION

cargo install clido-cli or via package managers like AUR.

HISTORY

Developed by Piotr KoĊ‚ata in 2023 as a Rust project on GitHub. Inspired by minimal todo tools; version 0.2.0 added tags and priorities. Actively maintained with Cargo crate for easy installation.

SEE ALSO

task(1), todoman(1), todo.txt(1)

Copied to clipboard