Vimango CLI

vimango-cli

A CLI tool for managing notes in the vimango notes system. Notes are organized by context (category/topic) and folder, and support full-text search.

Commands

List contexts and folders

vimango-cli contexts
vimango-cli folders

Always check available contexts/folders before creating or updating notes so you use valid names.

Search notes

vimango-cli search "query" [--limit N]

• Query must be at least 3 characters
• Default limit is 5 results
• Returns: rank, title, context, folder, and tid for each match

Get a note

vimango-cli get TID

• TID is the integer primary key
• Returns the full note content with title, context, folder, and body

Create a note

vimango-cli create --title "Title" --note "Body" [--context name] [--folder name] [--star]

• --title and --note are required
• Context and folder default to "none" if not specified
• Use --star to favorite the note
• Returns the tid of the created note

Update a note

vimango-cli update TID [--title "New Title"] [--context name] [--folder name] [--star/--no-star]

• At least one of --title, --context, --folder, or --star/--no-star must be provided
• Only the specified fields are changed

Workflow tips

1. Before creating/updating with a context or folder, run vimango-cli contexts or vimango-cli folders to confirm the name exists.
2. To find a note, use vimango-cli search first, then vimango-cli get TID to read the full content.
3. Exit codes: 0 on success, 1 on errors (missing context/folder, no results, note not found).
4. Errors go to stderr, normal output goes to stdout.