{
  "markdown": "# Gemini Readwise Extension\n\n[![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](https://opensource.org/licenses/ISC)\n[![Gemini CLI](https://img.shields.io/badge/Gemini-CLI-blueviolet)](https://geminicli.com)\n\nIntegrate 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.\n\n## Features\n\n- **Semantic Search**: Go beyond keywords with vector-based search to find conceptually related ideas.\n- **Expert Librarian Skill**: A specialized agent persona (`expert-librarian`) trained to act as your reference librarian, connecting dots across your reading history.\n- **Advanced Filtering**: Quickly pinpoint highlights by author, book title, or specific tags.\n- **Seamless Integration**: Native slash commands that work anywhere in your Gemini CLI session.\n\n## Prerequisites\n\n- [Gemini CLI](https://geminicli.com) installed.\n- A Readwise account with an active [Access Token](https://readwise.io/access_token).\n\n## Configuration\n\nSet your Readwise access token as an environment variable in your shell configuration (e.g., `.bashrc`, `.zshrc`, or `.envrc`):\n\n```bash\nexport READWISE_TOKEN=\"your_token_here\"\n```\n\n## Installation\n\nInstall the extension directly via the Gemini CLI:\n\n```bash\ngemini extensions install https://github.com/thoreinstein/readwise\n```\n\nAlternatively, for local development:\n\n```bash\ngit clone https://github.com/thoreinstein/readwise.git\ncd readwise\ngemini extensions link .\n```\n\n## Usage\n\n### Skill: Expert Librarian\n\nActivate 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.\n\n```bash\n/skill expert-librarian\n```\n\n**Example Queries:**\n- \"Summarize my recent reading on software architecture.\"\n- \"What are the common themes between my highlights on habit formation and productivity?\"\n- \"Find the specific highlight where I read about 'second brains'.\"\n\n### Slash Commands\n\nQuickly access your data with these built-in commands:\n\n| Command | Description |\n| :--- | :--- |\n| `/readwise:books` | List your 10 most recent books and articles. |\n| `/readwise:search <query>` | Perform a semantic search for a specific term or concept. |\n| `/readwise:insights <query>`| Search for conceptually \"near\" ideas to surface new connections. |\n| `/readwise:author <name>` | Search highlights from a specific author. |\n| `/readwise:book <title>` | Search highlights within a specific book or article. |\n| `/readwise:tag <tag>` | Filter highlights by a specific tag. |\n| `/readwise:daily` | Surface a random set of highlights for inspiration and review. |\n\n## Development\n\nThis extension wraps the [@readwise/readwise-mcp](https://github.com/readwise/readwise-mcp) server.\n\n## License\n\nISC License. See `LICENSE` (if provided) or `package.json` for details.",
  "bytes": 3023,
  "sha": "d081f1caafa9b52f36f965cf6a961060bc2b2dbaec8740344141d278af9fc8bd",
  "repo_slug": "thoreinstein/readwise",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_thoreinstein_readwise_8b9e581d/readme"
}