9 The Command-Line Client

OwnSona ships with a small standalone CLI under cli/ for reading from and writing to the memory store from the terminal. It’s useful for scripting, ad-hoc edits, and bulk-loading facts. Written in portable C; builds on Linux, macOS, and Windows (MSYS2 UCRT64) with one runtime dependency: libcurl.

Each MCP tool maps to a subcommand:

ownsona add    "<text>"           # remember
ownsona query  "<question>"       # recall
ownsona search "<substring>"      # text_search
ownsona list                      # list_memories
ownsona update <id> "<text>"      # update_memory
ownsona confirm <id>              # confirm
ownsona forget <id>               # forget
ownsona prompt "<user prompt>"    # build_context_prompt
ownsona import FILE               # remember_batch (JSON or one-per-line)
ownsona teach  FILE               # extract facts from prose via an LLM

The teach subcommand is covered in its own chapter (see The teach Workflow). The others are documented here.