Skip to content

CLI reference: notes

@bridge Notes — a local, private store of the markdown you produce with atbridge.ai (chat results, drafts, summaries). Files live under ~/.atbridge/user-data (override with $ATBRIDGE_NOTES_ROOT or the notes_dir config key). Notes never leave your machine, and atbridge uninstall preserves them by default (delete with --purge-notes). Part of the CLI reference.

CommandWhat it does
notes save --title <t>Save a note (body from --text, --from-file <path>, or piped stdin; --source, --tag, --folder <path>)
notes listList saved notes, newest first (recurses subfolders; --pretty)
notes search [query]Search notes across all fields (title, body, tags, source)
notes show <id-or-title>Print a note (--pretty renders the markdown)
notes edit <id>Edit a note in place (--title, --text/--from-file); keeps its id + created date
notes mv <id> <dest>Move or rename a note (dest is a relative path; an existing folder moves it in)
notes mkdir <path>Create a folder in the notes tree (relative, e.g. work/2026)
notes delete <id>Delete a note by id (aliases: rm, del)
notes pathPrint the notes directory
Terminal window
atbridge notes save --title "Acme proposal notes" --from-file draft.md --tag work
atbridge mail get <id> --raw | atbridge notes save --title "Thread to follow up"
atbridge notes list --pretty

Was this page helpful?