- Ngày 22/4/2026, Heptabase chính thức phát hành Heptabase CLI (v1.91.0) — cửa ngõ cho mọi AI coding agent ngồi trong terminal đọc, viết, và thao tác trực tiếp trên kho tri thức Heptabase của bạn.
- Đây là bước đi tiếp theo sau Heptabase MCP (12/2025), và là lần đầu một công cụ visual knowledge base ship CLI đóng gói riêng cho AI agent.
TL;DR
Ngày 22/4/2026, Heptabase phát hành Heptabase CLI trong bản v1.91.0. Bật CLI tại Settings → AI Features → CLI, bất kỳ AI coding agent nào (Claude Code, Codex, Cursor, Antigravity…) đều có thể tạo / đọc / sửa note cards và journals, search Card Library, quản lý tags, và đọc AI Tutor courses, lessons, chat history — trực tiếp từ terminal. Đây là lớp mới đặt lên trên Heptabase MCP (ra mắt 12/2025), biến kho tri thức visual của bạn thành backend có thể script hoá được.
Có gì mới
Thông điệp trên X của Heptabase rất gọn: "Today, we're excited to release the Heptabase CLI — a new way for external AI agents to interact with your local Heptabase knowledge base from the terminal." Sau khi bật trong Settings, CLI mở bốn nhóm quyền cho agent:
- Note cards & journals: create, read, edit
- Card Library: search theo keyword + semantic
- Tags: list, tạo, đổi tên, gỡ
- AI Tutor: đọc courses, lessons, chat history
Heptabase nói rõ đây mới là bước đầu: "we'll keep expanding the CLI surface so AI agents can act on your knowledge at the same depth that you can."
Vì sao đáng chú ý
Đa số visual note app (Notion, Obsidian, Reflect, Mem) đều có API, nhưng chưa app nào ship một CLI đóng gói riêng cho AI agent. Đặt cạnh thực tế agent coding đang dịch chuyển vào terminal (Claude Code, Codex, Aider, OpenCode), Heptabase là knowledge base đầu tiên ngồi cùng lớp với agent mà không cần chat app hoặc IDE plugin làm trung gian.
Về mặt kiến trúc, CLI đứng trên Heptabase MCP (ship 11/12/2025, v1.81.2) qua endpoint https://api.heptabase.com/mcp với OAuth. Nói cách khác: mọi thứ MCP đã làm được trong ChatGPT/Claude giờ có bản CLI gốc, phù hợp cho agentic loop, cron job, script dev workflow.
Tech facts nhanh
| Item | Chi tiết |
|---|---|
| Phiên bản | v1.91.0 (22/4/2026) |
| Bật ở đâu | Settings → AI Features → CLI |
| Giao thức nền | Model Context Protocol (MCP) |
| Endpoint MCP | https://api.heptabase.com/mcp |
| Xác thực | OAuth (browser redirect → Allow) |
| Agents hỗ trợ | Claude Code, Codex, Cursor, Antigravity, ChatGPT (Plus+) |
| Surface dữ liệu | Note cards, journals, Card Library, tags, AI Tutor, PDF, whiteboards |
Bộ 9 MCP tool đã công bố trước đó là nền cho CLI: save_to_note_card, append_to_journal, semantic_search_objects, search_whiteboards, get_whiteboard_with_objects, get_object, get_journal_range, search_pdf_content, get_pdf_pages. Trong đó get_journal_range trả tối đa ~3 tháng/request, còn search_pdf_content trả tối đa 80 ranked chunk với fuzzy OR matching.
So với trước khi có CLI
Trước 22/4: muốn Claude nói chuyện với Heptabase, bạn phải add MCP server trong app tương ứng — qua Settings của ChatGPT (Personal Plus trở lên), qua claude mcp add trong Claude Code, hoặc qua Manage MCP Servers trong Cursor/Antigravity. Mỗi app một cách cấu hình, mỗi phiên làm việc nằm trong UI chat.
Sau 22/4: agent có CLI độc lập. Agent đứng trong terminal, chạy lệnh Heptabase như chạy git, đưa output vào pipe/script, tự động hoá vòng đọc-ghi. Đặc biệt hợp với các workflow kiểu "đọc 7 journals gần nhất → tổng hợp → ghi lại thành card mới" mà trước đây rất khó chạy autonomous.
Use cases đáng thử ngay
- Coding agent cite note của bạn: Claude Code đọc card research trước khi trả lời câu hỏi, giảm hallucinate.
- Log tự động vào journal: script đẩy PR description, standup note, hoặc tóm tắt commit vào journal hôm nay qua
append_to_journal. - Weekly retrospective: agent pull journals 7 ngày, viết card tổng kết, gắn tag
weekly-review. - AI Tutor pipeline: đọc course/lesson/chat history, sinh flashcard, quiz, spaced-repetition prompt.
- Tag hygiene: rà tag trùng, rename theo convention, gỡ tag mồ côi.
- Research loop: semantic search Card Library → mở whiteboard → ghi connection mới giữa các ý.
Giới hạn & pricing
- CLI yêu cầu bật trong Settings — giả định gói của bạn đã có AI Features.
- ChatGPT path yêu cầu Personal Plus trở lên; Team plan hiện không hỗ trợ MCP connection.
- PDF lớn: không dùng
get_objecttrực tiếp, phải đi quasearch_pdf_content+get_pdf_pages. - Review journal range tối đa ~3 tháng/request.
- Heptabase chưa công bố rate-limit riêng cho CLI hay SSO enterprise.
Tiếp theo trên roadmap
Public roadmap (cập nhật 22/4) liệt kê ba hạng mục AI Agent đang ở trạng thái Working:
- AI Agent: Edit card content
- AI Agent: Edit whiteboard content
- AI Agent: View mention links, sub-whiteboards, and more
Hướng đi rõ ràng: agent không chỉ đọc/viết mà còn thao tác được trên whiteboard — nơi Heptabase khác biệt nhất so với Notion/Obsidian. Khi phần này ship, CLI sẽ là cửa duy nhất để các coding agent chạm tới toàn bộ hệ thống thị giác của Heptabase mà không cần chuyển sang app.
Nếu bạn là researcher, indie builder, hoặc AI-native knowledge worker đang chạy Heptabase + terminal agent hàng ngày, đây là bản cập nhật đáng bật ngay chiều nay.
Nguồn: Heptabase trên X, Changelog v1.91.0, Public Roadmap, Help Center — Heptabase MCP.
