New advertisers: 50% off your first month with code FIRSTMONTHSee slots

Local-first reading library search that finds passages, reads context, and cites sources.

version
0.1.4
GitHub stars
3.8K

What it does

  • Adds one sponge skill and a local MCP server that runs your installed sponge mcp against your existing library
  • Covers finding passages that answer a question, reading their surrounding context, and citing sources in the answer
  • Enforces that saving a URL or adding a note happens only when you ask, and that saved text stays data, never instructions
  • Designed for researchers and writers who keep saved articles and PDFs in a Sponge library on a machine they control

Find, read and cite passages from your Sponge reading library, a local-first library of saved articles and PDFs. The plugin adds one skill and a local MCP server that runs your installed Sponge CLI (sponge mcp) against your existing library. The launcher checks for the @hraness/sponge package first and refuses an unrelated sponge command; it installs nothing, signs in to nothing and creates no library. Saving a URL or adding a note happens only when you ask. Saved text stays data, never instructions.

Add marketplace

/plugin marketplace add davepoon/buildwithclaude

Run it inside Claude Code once, then install the plugin below.

Install

/plugin install sponge@buildwithclaude

Run it inside Claude Code after adding the marketplace.

Readme

Sponge for coding agents

Save articles and PDFs to a reading library captured by a computer you control. Highlight passages, keep notes, and find ideas through search or your coding agent.

This skill helps a coding agent find sources in your saved reading and answer questions from them. It also covers saving and annotating reading when you ask.

Connect your library

Install Sponge with Node.js >=24.20.0:

npm install --global @hraness/sponge@0.94.1

The task below uses a library that contains saved articles or PDFs. Follow the agent guide to create a library, save a first source, and connect your agent. Its local MCP command is sponge mcp.

Ask the agent to find passages in your saved reading that answer a question, read their context, and cite the sources in its answer. Search and reading work without an account or model download. The guide covers optional capture and sync setup, and links to platform requirements.

License

The skill and integration files use the MIT license. The Sponge application is proprietary.

Add the skill to an agent

Set up the product as described above, then install its integration files.

For Codex CLI:

codex plugin marketplace add https://github.com/hraness/product-skills.git
codex plugin add sponge@hraness-products

In Claude Code:

/plugin install sponge --marketplace hraness/product-skills

A Cursor team marketplace administrator can import https://github.com/hraness/product-skills, then select this product. See Cursor's repository import instructions. These repository installs are separate from public directory approval.

Local MCP setup

The included launcher checks the installed @hraness/sponge package and runs a read-only version probe before starting its MCP server. It refuses an unrelated sponge command. It does not install software, sign in or initialize a library.

The server uses your existing default library. To choose another existing library, set SPONGE_MCP_LIBRARY to its absolute directory in the agent's environment. If your Sponge command is outside PATH, set SPONGE_CLI to its absolute path. Follow the setup guide above when the launcher reports a missing command or library.

Details

Marketplace
davepoon/buildwithclaude
Source
plugins/sponge
Author
Hraness
Category
Productivity
License
MIT
Keywords
reading, read-later, research, citations, highlights, pdf, local-first, mcp

More from davepoon/buildwithclaude

All 237