cliary

A minimal command-line journal for writing, reading, and searching notes.

Notes are automatically grouped by day — each day gets its own file.

Installation

uv tool install cliary

Or you can also install locally with pip

pip install -e cliary

Quick Example

1. You can write about today

$ cliary write
>> today I learned about pathlib
>> built my first CLI tool
>> exit
Saved. Exiting...

and read what you have written about today

$ cliary read

today I learned about pathlib
built my first CLI tool

2. You can also write and search about yesterday (-1 from today)

$ cliary write -1
>> yesterday I install Linux
>> and learn about vim
>> exit
Saved. Exiting...

$ cliary read -1

yesterday I install Linux
and learn about vim

and you can also do that with tomorrow (1 from today).

3. You can exact search

$ cliary search good

2026-04-23.txt: weather is good today

Usage

Write notes:

cliary write

Note: You can exit writing by writing 'exit' or tapping 2 times.

Read today’s notes:

cliary read

Search notes:

cliary search <keyword>

Storage

Notes are stored in a logs/ directory in the home directory.

Example:

/home/me/
 ├── logs/
 │    ├── 2026-04-23.txt

Each day creates a new file.

Requirements

• Python 3.8+

License

MIT