We have the most powerful AI coding agents in history running right in our terminals, yet when it comes to researching our own documents, they still lack basic boundaries.
Point a standard agent at a local folder of PDFs, books, or notes and ask it to synthesize a concept. Half the time, it acts like an overly eager intern—confidently hallucinating a paper that doesn't exist, or blending three different authors into one contradictory mess.
Google completely solved this friction point with NotebookLM (recently rebranded to Gemini Notebook). It grounded the AI to a strict set of provided sources, killing the hallucination engine and forcing verifiable citations. It is brilliant. But it’s also a closed, cloud-only ecosystem.
I love the concept, but I wanted that exact magic running completely open-sourced, and accessible to any AI agent I happened to be using in my terminal.
So, I built it.
Meet agentic-notebook
agentic-notebook turns any local folder of documents into a strictly grounded research workspace for your AI agent.
Point your agent at a directory, and the skill indexes everything inside it into a local .notebook/ directory. From that moment on, the agent answers questions only from those sources. No invented sources. No guessing.
Key Features:
- Zero hallucinations. If the answer isn't in your folder, the agent will honestly give you a "the sources don't cover this" response.
- Exact, verifiable citations. Every claim comes with a receipt (
[1] book.pdf · p.41 · "exact quote from the page"). - Massive file support. It handles PDFs (with built-in OCR for scanned books), EPUB, DOCX, PPTX, Markdown, HTML, CSV, plain text, code, and subtitles. If your agent can transcribe or read them, it even supports audio, video, and image sources.
- Local indexing (with one caveat). The sources are read in place, and all indexed outputs live strictly inside that folder's
.notebookdirectory. However, keep in mind that if you use a cloud-based agent like Claude Code or Copilot, the agent will still read this data to generate its answers. Keep highly sensitive personal data out unless you are pairing this tool with a strictly local LLM.
Getting Started
Because it’s built on the skills CLI standard, it works out of the box with Claude Code, Gemini CLI, Cursor, Codex, Copilot, OpenCode, and virtually any other modern agent.
To install it globally, run:
npx skills add Harduex/agentic-notebook
(Claude Code users can alternatively grab it as a plugin via /plugin marketplace add Harduex/agentic-notebook and /plugin install agentic-notebook@harduex)
Once installed, you can simply invoke it by typing /agentic-notebook or using a natural language prompt in your target folder:
Act as a notebook over ./my-books — what do these authors disagree about on mastering loudness?
On the first run, the tool quietly spins up the .notebook workspace and indexes the files. After that, you have a completely grounded research assistant.
Skill Stacking: The Ultimate Study Environment
Retrieving facts is just the baseline. Where this tool really shines is when you start combining it with other agentic skills.
For example, you can stack it with Matt Pocock's excellent teach skill. Point agentic-notebook at a folder full of complex programming books or lesson materials to index the raw knowledge, and then invoke the teach skill to have the agent actively tutor you based only on the verifiable facts from those specific books. You can ask for flashcards, study guides, or quizzes, and every single answer will be strictly backed by your actual files.
The Requirements
You need Python 3.9+ installed on your system, and optionally tesseract (or easyocr) if you want to parse scanned books. But the bundled scripts prioritize the standard library, keeping the footprint light and auto-detecting PDF libraries when present.
The scripts themselves are plain, readable Python. As you always should with any skill that ships scripts, read them before installing.
We are moving past the era of just throwing raw text at an LLM and hoping for the best. Context is everything.
Your agent finally has a structured memory. Time to ask better questions.
