doggy-notes CLI

Fast note-taking in the terminal using SQLite storage.

Create and manage notes quickly without leaving the command line.

Features

• Create notes
• Delete single or multiple notes
• Note search
• SQLite storage
• Tag support
• Creation timestamps
• Read notes in details
• Edit notes
• Multiple export and import formats
• Trash to prevent accidental deletions

Installation

Clone the repository:

git clone https://github.com/Dev-ev-v/doggy-notes.git
cd doggy-notes

Install:

pip install .

Or:

pip install doggy-notes

Quick Start

Create a note:

doggy add "I love python"

List notes

doggy list

Delete a note:

doggy delete id 12345678

Command Reference

Command	Description
add	Create note
delete	Delete notes
list	Find notes
read	Show notes details
edit	Edit note
info	Show runtime informations
path	Show doggy-notes files
import	Import notes
export	Export notes
trash	Manage notes in trash

Storage

Notes are stored locally in SQLite.

Example structure:

{
 "id":"0123456789abcdefghijqwertyuiop32"
 "content":"Review argparse",
 "title":"Note",
 "description":"How to use argparse + examples"
 "tags":["python","cli"],
 "created_at":"2026-07-14 15:33:30.433805+00:00"
}

Roadmap

Planned:

• Encryption
• Backup support
• Automatic trash deletion
• Filter notes dedicated function
• Dedicated examples file
• Personalizated theme colors
• Notes with password
• More personalization

Why This Project

Built as a lightweight, fast and privacy-friendly terminal note manager.

Contributing

Issues and suggestions welcome.