
sponge
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
spongeskill and a local MCP server that runs your installedsponge mcpagainst 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/buildwithclaudeRun it inside Claude Code once, then install the plugin below.
Install
/plugin install sponge@buildwithclaudeRun 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- subagent-tunerv0.1.7
- suede-skillsv0.16.0
- symbiozav0.3.1
- testoptimv1.1.1
- textmockv0.1.3
- ti-edgeai-skillsv0.1.0
- tinyevalv0.11.1
- tlsradarv0.6.1
- tokentabv1.3.4
- toolbox-podv1.1.0
- tracekitv1.6.0
- traderspy-mcpv1.7.0
- travel-agent-skillv4.0.0
- treeproofv0.1.2
- ultracostv0.3.7
- ultramodv1.0.11
- usage-limitsv1.0.0
- usethisskillv1.2.0
- uxkinv1.3.0
- vibe-prospectingv0.1.56
- vibesenpaiv0.1.0
- visibilityv0.2.1
- voicemoat-skillsv1.1.2
- watch-for-mev0.1.4
Similar to sponge
More Productivity & Planning
code-reviewanthropics/claude-code156.1K starsAutomated code review for pull requests using multiple specialized agents with confidence-based scoring to filter false positives
cavemanJuliusBrussee/caveman121.1K starsTalk like caveman. Cut filler. Keep technical details explicit.
career-opscareer-ops-hq/career-ops83.4K starsOpen-source AI job search that runs locally in your AI coding CLI: scan job portals, evaluate listings into a structured A-H report with a 1-5 score, tailor you
ruflo-autopilotruvnet/ruflo82.2K starsAutonomous /loop-driven task completion with learning, prediction, and progress tracking
ppt-masterhugohe3/ppt-master78K starsGenerate natively editable PPTX from PDF / DOCX / URL / Markdown — real DrawingML shapes, text boxes, charts, and animations. Note: run `pip install -r requirem
moletw93/Mole75.4K starsDrive the Mole CLI (mo) safely: find what uses disk space, preview cleanup with --dry-run, uninstall apps, and read system health and cleanup history.