heptabase-cli

Search, read, and write Heptabase content from the terminal.

11|5|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/madeyexz/heptabase-cli --skill heptabase-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: heptabase-cli
Source: https://github.com/madeyexz/heptabase-cli/tree/main
Command: npx skills add https://github.com/madeyexz/heptabase-cli --skill heptabase-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Interact with your Heptabase knowledge base directly from the command line, enabling quick access to search, read, and write content without leaving the terminal.

Core Features & Use Cases

  • CLI access to search whiteboards, read cards/journals/PDFs, and create note cards or journal entries.
  • Workflow automation: save snippets as cards, append journal entries, and retrieve date-range journals.
  • Use Case: turn AI-generated outlines into permanent notes by saving them to Heptabase directly from scripts.

Quick Start

Use the CLI to save content as a note card.

Frequently Asked Questions about heptabase-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I interact with Heptabase from the terminal?

You can interact with Heptabase from the terminal by using this CLI tool to search, read, and write content directly across cards, journals, whiteboards, and PDFs without leaving your command line environment.

Can I automate saving AI-generated outlines to my knowledge base?

Yes, you can automate saving AI-generated outlines by using the save-to-note-card command within your scripts, turning generated text into permanent notes directly inside your Heptabase knowledge base.

What do I need to use a Heptabase CLI tool?

To use this Heptabase CLI tool, you need the MCP server and the CLI tooling installed in your environment, which together expose the commands required to interact with your local knowledge base.

How do I search whiteboards and journals from the command line?

You can search whiteboards and journals from the command line by using the search-whiteboards and semantic-search-objects commands to retrieve matching content and get specific objects via get-object.

Does this CLI support appending entries to a journal?

Yes, this CLI supports appending entries to a journal through the append-to-journal command, allowing you to quickly add snippets or daily logs to your Heptabase journal directly from the terminal.

What is the best way to turn terminal snippets into permanent notes?

The best way to turn terminal snippets into permanent notes is using the save-to-note-card command, which directly captures text outputs and saves them as structured cards in your Heptabase knowledge base.