noteman

A minimal CLI tool to create, view, and manage notes — right from your terminal. Each directory gets its own isolated notes database, so your work notes stay separate from your personal ones.

Installation

pip install noteman

Usage

Create a note

noteman make "title" "content"

noteman make "meeting" "discuss Q3 roadmap with team"

View notes

# Get by ID
noteman get --i 1

# Get by title
noteman get --t "meeting"

# List all notes
noteman get --a

Remove a note

# Remove by ID
noteman kick --i 1

# Remove by title
noteman kick --t "meeting"

Linux terminal shortcuts reference

# Show all shortcuts
noteman cuts

# Filter by category
noteman cuts --cat cursor
noteman cuts --cat function
noteman cuts --cat process
noteman cuts --cat text
noteman cuts --cat history
noteman cuts --cat misc

How notes are stored

noteman creates a notes.db SQLite file in the current directory when you run any command. This means each folder has its own independent set of notes — similar to how git works.

~/work/        → has its own notes.db
~/personal/    → has its own notes.db
~/project/     → has its own notes.db

No cloud, no sync, no accounts. Just a local SQLite file.

License

MIT © 2026