# New note from stdin
echo "# Content" | notes new --slug my-slug

# New note with frontmatter
echo "# Content" | notes new --title "Title" --tag journal --tag idea --description "Context"

# Empty note
notes new

# Today's todo (carries over pending tasks from previous todo)
notes new-todo

# Regenerate today's todo (also carries over in-progress tasks)
notes new-todo --force

# Append text to a note by ID, slug, or filename
echo "Additional content" | notes append my-slug

# Append to the latest note matching filters
echo "More text" | notes append --slug report --type note

# Create note if no match found (atomic check-and-create)
echo "- [ ] Ship feature" | notes append --type todo --create

# Create with frontmatter (--title and --description require --create)
echo "- First entry" | notes append --slug report --create --title "Session Report"

# List recent notes
notes ls --limit 10

# List by type, slug, or tag
notes ls --type todo --limit 1
notes ls --slug report
notes ls --tag journal --tag idea

# Find notes matching a fragment in ID, slug, or filename
notes filter 8823
notes filter todo

# Read a note by ID, slug, or filename
notes read 8823
notes read todo

# Read without frontmatter
notes read todo --no-frontmatter

# Path to latest note (optionally filtered by type, slug, or tag)
notes latest
notes latest --type todo
notes latest --slug report
notes latest --tag journal

# Filters are repeatable (OR within same flag, AND across flags)
notes latest --slug report --slug todo
notes latest --type todo --type backlog

# Search note contents (passes args to grep)
notes grep "pattern"
notes grep -i "case insensitive"
notes grep -l "files only"

# Search note contents using ripgrep
notes rg "pattern"
notes rg -i "case insensitive"
notes rg -l "files only"

# Print the notes archive directory path
notes path