Start with Sponge
For agents
Give your agent this page’s Markdown link, or choose a collection.
- Documentation indexFind a guide and its Markdown link.
- Full documentationRead all curated guides in one text file.
- Machine manifestFind page metadata, Markdown URLs and checksums.
Sponge is a reading library. You save articles and PDFs, a computer you control captures a readable copy, and you read, highlight and take notes in a browser, on a Mac or from a terminal.
The sponge command does the capturing and keeps the result in a local SQLite library. Optional sync carries the text to the web library and the apps. Claude Code, Codex, OpenCode and other coding agents can use the same library through the CLI or MCP. How Sponge works explains the parts.
Save your first article
Section titled “Save your first article”Use Node.js 24.20 or newer on macOS or Linux. Article capture is included; this first task needs network access to the source page and writes a local library. No account is needed.
npm install -g @hraness/spongesponge initsponge add https://example.com --waitsponge listThe saved item appears in the list with an item ID. Use that ID to read the saved copy and add a note:
sponge show ITEMsponge comment ITEM "Why I saved this source"sponge search "example"sponge open shows the same library as pages in your browser, with no connection and no account.
Once a few things are saved, sponge ask answers a question from them with the local model and shows the quote behind each statement.
Replace ITEM with the ID from the list. Add --json to any command for structured output. The default library is ~/.local/share/sponge; use --library /absolute/path for another one.
Read it in a browser
Section titled “Read it in a browser”sponge loginsponge syncsponge login prints a link and a code; approve the computer in a browser, signing in with an email code, a passkey or a Sponge key. After sponge sync, open account.sponge.computer/library.
The web library has an inbox, a read-later queue, an archive, stars and reading progress. It keeps its own copy for reading and search, so it works offline once loaded. Highlights and notes collect in a notebook that exports Markdown. Keyboard shortcuts lists every key.
Save from anywhere
Section titled “Save from anywhere”Links saved from the web library, the Mac app, Chrome or a phone wait in a queue until a computer running sponge captures them. Keep one capturing with sponge sync --watch, or install the background worker. Ways to save covers each entry point.
- Sponge for Mac is available now as a signed, notarized download.
- The iPhone and iPad app is on the App Store.
- Sponge for Chrome is on the Chrome Web Store.
What needs more setup
Section titled “What needs more setup”Reading, keyword search, highlights, notes, sync and export work everywhere with nothing extra. Summaries need a model download. Media transcripts, CLI semantic search and building the library map need native helpers that run only on Apple Silicon Macs with macOS 26. Requirements and platforms has the full table.
Storage and privacy
Section titled “Storage and privacy”Capture and models run on your computers. The cloud holds synced text only; images load from the sites that published them, and PDF files stay on the devices that hold them. Cloud copies use TLS and the storage provider’s protections, and a new library is also end-to-end encrypted. One first synced before Sponge 0.59.0, or after sponge login --plain, is not until you run sponge sync encrypt. Items are private until you share or publish them.
- Questions answers what is free, what is private, and how Sponge compares with hosted read-later services.
- Use a coding agent to search, read, save and annotate through the CLI or MCP.
- The CLI reference and MCP reference list every command and tool.
- The Clip API queues links from your own tools. A clip token can queue saves but cannot read the library.
- On a server, follow Linux.
Sponge does not publish a separately supported JavaScript SDK. Programmatic integrations use the CLI’s JSON output, MCP or the Clip API.
Documentation drafted with AI and checked against the product source.