heptabase-clilisted

# Heptabase CLI A CLI that wraps the Heptabase MCP server. Search, read, and write to your Heptabase knowledge base from the terminal. ## Prerequisites - The `heptabase` binary must be on your PATH (see https://github.com/madeyexz/heptabase-cli) - First run opens a browser for OAuth login; tokens cache in `~/.mcp-auth/` ## Tools ### 1. Save as a card (`save-to-note-card`) Creates a new note card in your Heptabase Inbox (like the Web Clipper). ```bash heptabase save-to-note-card --content "# Title Body text in markdown" ``` - First h1 line becomes the card title - Great for: turning AI answers into permanent notes, saving outlines/plans/summaries, capturing ideas to organize later on a whiteboard ### 2. Append to journal (`append-to-journal`) Adds content as new blocks to today's journal. Does NOT overwrite existing content. Auto-creates today's journal if it doesn't exist. ```bash heptabase append-to-journal --content "Some journal entry" ``` - Ideal for: daily reflections, quick logs ("summarize what I worked on today"), capturing ideas that belong in your daily record ### 3. Semantic search (`semantic-search-objects`) Finds objects in your knowledge base using full-text + semantic (meaning-based) search. ```bash # 1-3 natural language queries, comma-separated # result-object-types: card,pdfCard,mediaCard,highlightElement,journal (or empty for all) heptabase semantic-search-objects --queries "machine learning,neural networks" --result-object-types "card,pdfCa