readwise
Readwise integration for Gemini CLI including an Expert Librarian skill.
Open source Open in the app JSON README (API)
About
Readwise integration for Gemini CLI including an Expert Librarian skill.
Details
- Kind
- Plugins
- Topic
- AI, RAG & memory
- Publisher
- thoreinstein
- Origin
- gemini
- Category
- ferramentas
- Version
- 1.0.0
- Stars
- 5
- Forks
- 1
- Last push
- 2026-02-07T14:25:13Z
- Repository state
- ativo
- Added
- 2026-08-30 14:13:39
- Updated
- 2026-08-30 14:13:39
- Origin id
thoreinstein/readwise
README
# Gemini Readwise Extension [](https://opensource.org/licenses/ISC) [](https://geminicli.com) Integrate your [Readwise](https://readwise.io/) highlights and reading history directly into the Gemini CLI. This extension leverages the Model Context Protocol (MCP) and a specialized AI Librarian to help you search, synthesize, and discover insights from your personal knowledge base. ## Features - **Semantic Search**: Go beyond keywords with vector-based search to find conceptually related ideas. - **Expert Librarian Skill**: A specialized agent persona (`expert-librarian`) trained to act as your reference librarian, connecting dots across your reading history. - **Advanced Filtering**: Quickly pinpoint highlights by author, book title, or specific tags. - **Seamless Integration**: Native slash commands that work anywhere in your Gemini CLI session. ## Prerequisites - [Gemini CLI](https://geminicli.com) installed. - A Readwise account with an active [Access Token](https://readwise.io/access_token). ## Configuration Set your Readwise access token as an environment variable in your shell configuration (e.g., `.bashrc`, `.zshrc`, or `.envrc`): ```bash export READWISE_TOKEN="your_token_here" ``` ## Installation Install the extension directly via the Gemini CLI: ```bash gemini extensions install https://github.com/thoreinstein/readwise ``` Alternatively, for local development: ```bash git clone https://github.com/thoreinstein/readwise.git cd readwise gemini extensions link . ``` ## Usage ### Skill: Expert Librarian Activate the skill to enter a high-context mode for knowledge management. The Librarian understands how to use semantic search to synthesize information across your entire library. ```bash /skill expert-librarian ``` **Example Queries:** - "Summarize my recent reading on software architecture." - "What are the common themes between my highlights on habit formation and productivity?" - "Find the specific highlight where I read about 'second brains'." ### Slash Commands Quickly access your data with these built-in commands: | Command | Description | | :--- | :--- | | `/readwise:books` | List your 10 most recent books and articles. | | `/readwise:search <query>` | Perform a semantic search for a specific term or concept. | | `/readwise:insights <query>`| Search for conceptually "near" ideas to surface new connections. | | `/readwise:author <name>` | Search highlights from a specific author. | | `/readwise:book <title>` | Search highlights within a specific book or article. | | `/readwise:tag <tag>` | Filter highlights by a specific tag. | | `/readwise:daily` | Surface a random set of highlights for inspiration and review. | ## Development This extension wraps the [@readwise/readwise-mcp](https://github.com/readwise/readwise-mcp) server. ## License ISC License. See `LICENSE` (if provided) or `package.json` for details.