buku

# buku — Bookmark Manager

CLI bookmark manager with SQLite backend. Always use `--nostdin` and `--np` flags to prevent interactive prompts.

## Common Operations

### Add bookmark
```bash
buku --nostdin -a "URL" --tag tag1,tag2 --title "Title" -c "Description"
```
Omit `--title` to auto-fetch from web. Use `--offline` to skip fetching.

### Search
```bash
# Any keyword
buku --nostdin --np -s keyword1 keyword2

# All keywords
buku --nostdin --np -S keyword1 keyword2

# By tag (ANY match with comma, ALL match with +)
buku --nostdin --np -t tag1,tag2
buku --nostdin --np -t tag1+tag2

# Regex
buku --nostdin --np -r "pattern"

# Deep search (substring matching)
buku --nostdin --np -s keyword --deep
```

### List/Print
```bash
# Last N bookmarks
buku --nostdin --np -p -5

# All bookmarks
buku --nostdin --np -p

# Specific index
buku --nostdin --np -p 42

# JSON output (preferred for parsing)
buku --nostdin --np -p -j

# Limit fields: 1=URL, 2=URL+tag, 3=title, 4=URL+title+tag, 5=title+tag
buku --nostdin --np -p -f 4
```

### List all tags
```bash
buku --nostdin --np -t
```

### Update bookmark
```bash
# Update fields at index
buku --nostdin -u INDEX --url "NEW_URL" --title "New Title" --tag tag1,tag2

# Append tags
buku --nostdin -u INDEX --tag + newtag1,newtag2

# Remove tags
buku --nostdin -u INDEX --tag - oldtag

# Refresh title/description from web
buku --nostdin -u INDEX
```

### Delete
```bash
# By index (use --tacit to skip confirmation)
buku --nostdin --tacit -d INDEX

# Range
buku --nostdin --tacit -d 10-20
```

### Import/Export
```bash
# Import from browser
buku --nostdin --ai

# Import from file (.html, .md, .json, .org, .db)
buku --nostdin -i bookmarks.html

# Export to markdown
buku --nostdin -e bookmarks.md

# Export search results
buku --nostdin -s keyword -e results.md
```

### Tag management
```bash
# Replace tag everywhere
buku --nostdin --replace oldtag newtag

# Delete tag everywhere
buku --nostdin --replace oldtag
```

## Important Notes

- **Always...