@postnesia/cli

Commander CLI for the Postnesia memory system. A like-for-like interface over the MCP tools for use when no MCP connection is available.

Usage

npx postnesia <command> [options]

Requires DATABASE_URL and GEMINI_API_KEY in a .env file in your working directory, or set as environment variables.

Commands

Memory

postnesia memory search "<query>" [--limit N]
postnesia memory add "<content>" --type <type> --importance <1-5> --tags "<t1,t2>" [--content-l1 "<summary>"] [--context "<ctx>"] [--core]
postnesia memory update-core <id> --content "<content>" --content-l1 "<summary>"
postnesia memory recent [--hours N] [--limit N]
postnesia memory stats
postnesia memory consolidate
postnesia memory relationships <id>

Memory types: event decision lesson preference person technical

Journal

postnesia journal add <YYYY-MM-DD> "<content>" [--learned "..."] [--learned-about-rye "..."] [--key-moments "..."] [--mood "..."]
postnesia journal recent [--days N]

Tasks

postnesia task create "<title>" [-d "<description>"] [-s <session-id>] [-m <memory-id>]
postnesia task update <id> [-s <status>] [-t "<title>"] [-d "<description>"]
postnesia task list [--status <status>] [--session-id <id>] [-l N]

Task statuses: pending in_progress completed cancelled

Notes

• memory search uses Gemini vector embeddings — GEMINI_API_KEY is required
• memory add and memory update-core also embed content before writing
• Output is JSON for list/search commands; plain text for mutations