Shelf: one library for you and your agents

Not just markdown.

CSV files open as tables. Images and PDFs get their own viewers. JSON and source code are structured and highlighted, with raw source one click away.

retrieval-notes.md · PREVIEW

Retrieval notes

Chunk boundaries matter more than embedding choice. Three runs over the same corpus, and the only variable that moved recall was where we split the document.

What we changed

Split on headings, not token count

Keep the parent heading in every chunk

Re-run the eval on the long-document set

Tables, checklists, code blocks, links and nested lists all render, and all round-trip back to clean Markdown when you save.

eval-run-114.json · PREVIEW

1{
2  "run": 114,
3  "strategy": "heading-split",
4  "corpus": "long-documents",
5  "metrics": {
6    "recall@10": 0.914,
7    "precision@10": 0.782,
8    "median_latency_ms": 148
9  },
10  "regressions": [],
11  "passed": true
12}

Keys, strings and numbers are coloured, nesting is collapsible, and invalid JSON is caught before it can be saved.

latency-by-region.csv · PREVIEW

Region	Edge	p50 ms	p99 ms	Requests
us-east	IAD	41	118	1,284,003
eu-west	DUB	38	102	908,441
ap-south	BOM	56	163	412,770
sa-east	GRU	62	181	204,118
af-south	CPT	71	209	88,652

Delimited data becomes a real table with a header row, not a wall of commas you have to parse in your head.

chunker.ts · SOURCE

1// Split on headings, carrying the parent down.
2export function chunk(doc: Document): Chunk[] {
3  const out: Chunk[] = [];
4  let parent = '';
5
6  for (const block of doc.blocks) {
7    if (block.type === 'heading') parent = block.text;
8    else out.push({ parent, text: block.text });
9  }
10
11  return out;
12}

Syntax highlighting, code folding, in-file search, line wrapping and an indentation setting that respects the file you're actually in.

summary.html · SOURCE

1<section class="digest">
2  <h1>Week 38</h1>
3  <p>Recall up 4.1 points after the
4     chunker change.</p>
5</section>

Deliberately not executed. HTML and SVG artifacts are shown as source or served as a download, never rendered live on the app's own origin. A file someone else wrote should not get to run as you.

A real editor, built in.

Files open rendered and edit in place, so correcting a number or rewriting a paragraph doesn't mean exporting it somewhere else and bringing it back.

Rich Markdown with tables, checklists and code blocks, exported back as clean Markdown
A syntax-aware editor for everything else, with folding, search and formatting for six languages
Drafts survive reloads. Invalid JSON is caught before it can overwrite something good.

app.getshelf.dev / specs / chunking-v2.md

chunking-v2.md PREVIEWEDIT

Chunking v2

Heading-aware splitting, with the parent carried into every child chunk.

Strategy	Recall	Δ
Fixed 512	0.873	—
Heading split	0.914	+4.1

Ship behind a flag

Backfill the existing index

Hand someone the file, not a paste.

Share one artifact or a whole folder with an email address. They open the real document, and if you give them edit access their changes land in the same file instead of a copy that quietly drifts out of date. Someone without an account can have a link.

View or edit, on a single file or a whole folder. A folder grant covers everything inside it, including files added later
Access follows the verified email address. Copying the app's URL for a file grants nothing
Anonymous links are unguessable, kept out of search engines, rate-limited and revocable, and one screen lists everything reachable without signing in
Your labels, colours and stars stay yours. They never travel with the file

The first share to someone emails them an invitation that names you and nothing else. Later shares to the same person within 24 hours stay quiet, so an agent sharing thirty files sends one email, not thirty.

Hard to lose.

Every save writes a new version instead of painting over the last one, so a bad overwrite is something you recover from rather than something you explain.

VersionedEvery save writes a new version. Yesterday's copy is still there when today's goes wrong.
Private by defaultNothing leaves your library until you share it, with a person by address or with a link you can revoke at any time.
Still youngShelf is new. Keep your own copy of anything you cannot afford to lose.

For agents and people

Your agents get a shelf too.

Install the skills once and Claude, Codex or Cursor work from the same library you do. Same files, same folders, same sharing. An agent writes the report, you fix the number it got wrong, and whoever needs it opens the file rather than a wall of chat.

01 / Install the CLI
npm install -g @shelftrove/cli
02 / Connect your account
trove auth login
03 / Install the agent skills
trove skills install

Node 20.11 or newer, no runtime dependencies. Every command takes --json, and the JSON is the contract.

~/work

$ claude "Find the 10 accounts that grew fastest

this month, write it up, and share it with sales@example.com"

● shelf read crm/exports, 1,284 accounts

● shelf-index wrote reports/growth-2026-09.md

● shelf shared with sales@example.com ✓

$ codex "Ravi shared a spec with me. Read it

and list what we still need before we can start"

● shelf opened partner-integration.md

shared by ravi@partner.co · view

● shelf-index wrote notes/integration-gaps.md

Both files are on your shelf.

$

Free while it's new.

Everything on this page works today at no cost. These are the real limits, not a headline number with an asterisk under it.

Storage: 1 GB per account.
Files: Up to 100,000 artifacts.
File size: 1 MB each. Text goes a long way at that size.
Writes: 100 a minute, 5,000 a day. An agent working flat out stays inside that.
Reads: 600 a minute.
Other changes: 300 a minute for renames, keywords, labels and folders.
Sign-in codes: 10 an hour from one network address.
History: The last 3 versions of every file, and you can raise it to 100. Older versions are kept for up to 30 days.
Deleted files: Recoverable for 30 days before they are purged.
Sharing: Up to 100 people per file or folder, as viewer or editor.
Links: 100 new anonymous links an hour, once your account is a day old.
Agents: Every skill, on every agent you use. No separate tier.

A paid plan with higher limits and more features is something we are thinking about. Nothing is decided and nothing is scheduled, so please treat that as an intention rather than a promise. If it happens, what you have already put in Shelf stays yours and stays reachable.

Questions

What is Shelf?

A private library for the artifacts you and your agents produce. It renders Markdown, JSON, CSV, images, PDFs and source code properly, keeps HTML and SVG as readable source, lets you edit text in place, and keeps everything in folders with labels, colours and stars. A library, not a chat app: what you put in it is still there, and still findable, a month later.

Where is my content stored?

On managed cloud infrastructure, encrypted in transit and at rest. File contents are written immutably, so saving creates a new version rather than overwriting what was there.

Can my agents use it?

Yes, and that is most of the point. Install the Trove skills and Claude, Codex or Cursor read from and write to the same library you use, including files other people have shared with you. An agent can open a spec a colleague sent, work from it, and leave its output in a folder you already know how to find.

Can I share a file?

Yes, in two ways. Share with an email address, as view or edit, on a single file or a whole folder; the first share to someone emails them an invitation, and later shares to them within 24 hours don't send another. Or mint an anonymous link that anyone holding it can open: it is unguessable, kept out of search engines, rate-limited, can be set to expire, and you can revoke or rotate it at any time. Links become available once your account is a day old.

Make room for the work.

Sign in with your email and start putting things somewhere they'll survive.

Open your shelf How we handle your data

Your files.One place.

Retrieval notes

What we changed

Not just markdown.

Retrieval notes

What we changed

A real editor, built in.

Chunking v2

Hand someone the file, not a paste.

Hard to lose.

Your agents get a shelf too.

Free while it's new.

Questions

Make room for the work.

Your files.
One place.