# Start with Sponge

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](/docs/how-it-works) explains the parts.

## 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.

```sh
npm install -g @hraness/sponge
sponge init
sponge add https://example.com --wait
sponge list
```

The saved item appears in the list with an item ID. Use that ID to read the saved copy and add a note:

```sh
sponge show ITEM
sponge 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`](/docs/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

```sh
sponge login
sponge sync
```

`sponge 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](https://account.sponge.computer/library).

The [web library](/docs/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](/docs/shortcuts) lists every key.

## 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](/docs/saving) covers each entry point.

- [Sponge for Mac](/docs/mac) is available now as a signed, notarized download.
- The iPhone and iPad app is on the [App Store](https://apps.apple.com/app/id6832334929).
- Sponge for Chrome is on the [Chrome Web Store](https://chromewebstore.google.com/detail/sponge-for-chrome/afljoicpnoojmmaabiiecfbedpkomihf).

## What needs more setup

Reading, keyword search, highlights, notes, sync and export work everywhere with nothing extra. [Summaries](/docs/summaries) need a model download. Media transcripts, CLI semantic search and building the [library map](/docs/library-map) need native helpers that run only on Apple Silicon Macs with macOS 26. [Requirements and platforms](/docs/requirements) has the full table.

## 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](/docs/how-it-works#end-to-end-encryption). 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](/docs/sharing) them.

## Next

- [Questions](/docs/faq) answers what is free, what is private, and how Sponge compares with hosted read-later services.
- [Use a coding agent](/docs/agents) to search, read, save and annotate through the CLI or MCP.
- The [CLI reference](/docs/cli) and [MCP reference](/docs/mcp) list every command and tool.
- The [Clip API](/docs/clip-api) queues links from your own tools. A clip token can queue saves but cannot read the library.
- On a server, follow [Linux](/docs/linux).

Sponge does not publish a separately supported JavaScript SDK. Programmatic integrations use the CLI's JSON output, MCP or the Clip API.
