# Trove Docs

> Trove is a library AI agents read from.
> Agents reach it through the `trove` CLI or the MCP server
> and answer with book-and-page citations.

Each link below is one Markdown page. Load only the pages your task needs.

## Get started
- [Introduction](https://docs.heytrove.ai/index.md): Use when you are new to Trove and need to know what it is, how it works in three steps, and which page to open next.
- [Quickstart](https://docs.heytrove.ai/quickstart.md): Use when you want the shortest path from nothing to a first cited answer, with one book added and your agent reading it.
- [Install in your agent](https://docs.heytrove.ai/install.md): Use when you are installing Trove into a specific agent, choosing which agents get it, connecting Claude or ChatGPT, or fixing an install problem.
- [How Trove works](https://docs.heytrove.ai/how-trove-works.md): Use when you want to understand what happens between your question and a cited answer, and how to make sure your agent checks the library.

## Concepts
- [Overview](https://docs.heytrove.ai/concepts.md): Use when you need a one-line definition of each Trove idea (library, shelf, manuscript, plan mode and more) and a link to the page that covers it.
- [Library and books](https://docs.heytrove.ai/concepts/library-and-books.md): Use when you need to know what a book is in Trove, how to add, read, edit or repair one, or why a read or import failed.
- [Marketplace](https://docs.heytrove.ai/concepts/marketplace.md): Use when you want to find books by other authors, subscribe to one, understand Professional-only books, or publish your own.
- [Shelves](https://docs.heytrove.ai/concepts/shelves.md): Use when you want your agent to read certain books first for one project, or to share that choice with your repo and teammates.
- [Manuscripts](https://docs.heytrove.ai/concepts/manuscripts.md): Use when you want agents to record what they learn in a living note, or to control when they write to it.
- [Plan mode and auto mode](https://docs.heytrove.ai/concepts/plan-and-auto-mode.md): Use when you want to change the setting for Trove's automatic library checks, or to understand why your agent did or did not check.
- [Knowledge gaps](https://docs.heytrove.ai/concepts/knowledge-gaps.md): Use when no book answered your question, a book is missing a section, or you author books and want to see and close reader requests.
- [Citations](https://docs.heytrove.ai/concepts/citations.md): Use when you want to check where an answer came from, read the Trove citation block, or turn the block off.
- [Teams](https://docs.heytrove.ai/concepts/teams.md): Use when you are inviting people, grouping them into departments, or controlling which team members can read or edit a shared book.

## Subagents
- [Overview](https://docs.heytrove.ai/subagents.md): Use when you need to know which Trove subagent does what: the librarian, item reader, book writer and book enricher. Covers when each one starts, what each never does, and which model it runs on.
- [Librarian](https://docs.heytrove.ai/subagents/librarian.md): Use when you need to know how Trove picks books for a task. Covers what the librarian looks at, what its reading list contains, how shelves change the ranking, and what happens when no book fits.
- [Item reader](https://docs.heytrove.ai/subagents/item-reader.md): Use when you need to know how Trove reads books and cites them. Covers which pages an item reader opens, the citation format, the report it returns, and how it handles read limits and broken books.
- [Book writer](https://docs.heytrove.ai/subagents/book-writer.md): Use when you want your agent to create or edit a book or manuscript in Trove. Covers how the book writer edits safely when other agents share the book, the page model, size caps, and how to recover a version.
- [Book enricher](https://docs.heytrove.ai/subagents/book-enricher.md): Use when a book in your Trove library has a file name for a title or no author, description or table of contents. Covers what the book enricher fills in, when it runs, and how to queue a book for it.

## Best practices
- [Overview](https://docs.heytrove.ai/best-practices.md): Use when you want to pick the right Trove best-practice page. Routes you to guides on what goes in the library, project shelves, readable books, manuscripts, trustworthy answers and team setup.
- [Decide what goes in your library](https://docs.heytrove.ai/best-practices/what-goes-in-the-library.md): Use when you choose which documents, skills and reference books to add to your library, and which to leave out.
- [Build a project shelf](https://docs.heytrove.ai/best-practices/project-shelf.md): Use when you want your agent to read the same books on every task in a project. Covers how to build a project shelf, how to grow it and when to use a topic shelf instead.
- [Write books agents can read](https://docs.heytrove.ai/best-practices/write-books-agents-can-read.md): Use when you write or import a book that agents will read. Covers chapter structure, explanations with rules and reasons, one chapter per page, page-level edits and approval.
- [Manuscripts that stay useful](https://docs.heytrove.ai/best-practices/manuscripts-that-stay-useful.md): Use when you keep a manuscript that agents add to over time. Covers where learnings go first, the log when line, approval and auto-update per manuscript, and moving entries into chapters.
- [Get answers you can trust](https://docs.heytrove.ai/best-practices/answers-you-can-trust.md): Use when you need to check that an agent answer comes from your books. Covers asking explicitly, page citations, reading pages instead of summaries, conflicting books and topics no book covers.
- [Run Trove for a team](https://docs.heytrove.ai/best-practices/run-trove-for-a-team.md): Use when you set up Trove for several people or plan to publish a book in the marketplace. Covers where team knowledge lives, who gets write access, department sharing and what to check before a book goes public.

## Usage
- [Overview](https://docs.heytrove.ai/usage.md): Use when you want to pick the right Trove usage guide. Routes you to step-by-step guides for setting up your library, research, planning, writing, logging and sharing.
- [Set up your library](https://docs.heytrove.ai/usage/set-up-your-library.md): Use when your Trove library is new or nearly empty. Covers turning your existing agent skills into books, picking marketplace books for your work, and creating a project shelf.
- [Research a topic](https://docs.heytrove.ai/usage/research-a-topic.md): Use when you want your agent to research a topic from your books. Covers how to ask it explicitly to search your Trove library, what you see, and how to read the cited answer.
- [Plan a feature with your library](https://docs.heytrove.ai/usage/plan-a-feature.md): Use when you want a plan that draws on your books. Covers how to ask your agent explicitly to search your Trove library while it plans, and what changes in the plan.
- [Write a book with your agent](https://docs.heytrove.ai/usage/write-a-book.md): Use when you want your agent to write a book in your library. Covers the outline, the draft, import of a file, and how to review and edit the result.
- [Log what you learn](https://docs.heytrove.ai/usage/log-what-you-learn.md): Use when you want your agent to keep what a project teaches in a manuscript. Covers creating a manuscript, how entries get written and how to see which manuscripts are active.
- [Share a library with your team](https://docs.heytrove.ai/usage/share-a-library.md): Use when you want teammates to read the same books. Covers sharing books through the team library, setting read or write access by department, and committing a project shelf file.

## Reference
- [Overview](https://docs.heytrove.ai/reference.md): Use when you need to pick how to reach Trove from code: the CLI, the REST API or the MCP server. Routes you to the right reference page.
- [CLI](https://docs.heytrove.ai/reference/cli.md): Use when you run Trove from a terminal or a coding agent and need the command groups, global flags, environment variables and common errors of the trove CLI.
- [trove auth](https://docs.heytrove.ai/reference/cli/auth.md): Use when you sign the CLI in or out, sign in on a server or CI machine with an API key, or check which account and plan the CLI uses.
- [trove items: read](https://docs.heytrove.ai/reference/cli/items.md): Use when you list your books, read a table of contents, read pages, wait for an import to finish or export a whole book with the trove items commands.
- [trove items: write](https://docs.heytrove.ai/reference/cli/items-writing.md): Use when you add a file, create or edit a markdown book, append to it, import a large file, roll back a version, or remove or re-import a book with the trove items commands.
- [trove items: gaps](https://docs.heytrove.ai/reference/cli/items-gaps.md): Use when a book you read is missing a topic and you report it to the author, or when you wrote a book and want to see, resolve or reopen reader requests with the trove items commands.
- [trove shelf](https://docs.heytrove.ai/reference/cli/shelf.md): Use when you group books on shelves, pin a project to a shelf, or share a shelf manifest with your team using trove shelf and trove init.
- [trove ms](https://docs.heytrove.ai/reference/cli/ms.md): Use when you create, list, show, change, pause or archive manuscripts, the living books an agent keeps up to date, with the trove ms commands.
- [trove marketplace](https://docs.heytrove.ai/reference/cli/marketplace.md): Use when you browse the public marketplace, add a listed book to your library, or remove one again with the trove marketplace commands.
- [trove team](https://docs.heytrove.ai/reference/cli/team.md): Use when you run a team library from the terminal: invite and remove members, manage departments, and decide which books the team and each department can read.
- [trove setup](https://docs.heytrove.ai/reference/cli/setup.md): Use when you install Trove into your coding agents, turn it on or off for one agent, update the binary, check the version, or run the first-run commands scan, welcome and tour.
- [trove config](https://docs.heytrove.ai/reference/cli/config.md): Use when you read or change personal Trove settings, such as plan mode and the citation block, from the terminal with trove config.
- [trove sources](https://docs.heytrove.ai/reference/cli/sources.md): Use when you list or delete the saved sources in your Trove account, such as tweets saved with the browser extension, with the trove sources commands.
- [trove value](https://docs.heytrove.ai/reference/cli/value.md): Use when you want to see what your agents read from your library, as a personal report with sessions, top books and activity, using the trove value command.
- [trove report](https://docs.heytrove.ai/reference/cli/report.md): Use when you send a bug report, feature request or idea to the Trove support inbox from the terminal or from an agent with the trove report command.
- [API](https://docs.heytrove.ai/reference/api.md): Use when you call Trove over HTTP and need the base URL, authentication, error shapes, rate limits and the list of every endpoint with a link to its page.
- [Auth API](https://docs.heytrove.ai/reference/api/auth.md): Use when you check that an API key works and read the account, plan, library size and monthly read usage behind it with GET /auth/whoami.
- [Items API](https://docs.heytrove.ai/reference/api/items.md): Use when you list, create, delete, enrich, flag or re-import books over HTTP with the /items endpoints. Reading and writing page text have their own pages.
- [Reading API](https://docs.heytrove.ai/reference/api/items-read.md): Use when you read a book over HTTP: get tables of contents, read chosen pages from up to 50 books in one call, or export a whole book. Every book you open counts as one read.
- [Writing API](https://docs.heytrove.ai/reference/api/items-write.md): Use when you replace a book, replace one page, append or prepend content, list versions or restore a version over HTTP, and need the version check that stops two writers overwriting each other.
- [Gaps API](https://docs.heytrove.ai/reference/api/gaps.md): Use when you report a topic a book or the library is missing, or when you wrote a book and list, resolve, decline or reopen the reader requests for it over HTTP.
- [Shelves API](https://docs.heytrove.ai/reference/api/shelves.md): Use when you list, create, rename, delete or fill shelves over HTTP. A shelf is a named group of your books, addressed by id or slug.
- [Manuscripts API](https://docs.heytrove.ai/reference/api/manuscripts.md): Use when you list, create, update, pause or archive manuscripts over HTTP. A manuscript is a book an agent keeps up to date from research sessions.
- [Marketplace API](https://docs.heytrove.ai/reference/api/marketplace.md): Use when you browse public marketplace listings without a key, or add a listed book to your library and remove it again over HTTP.
- [Upload API](https://docs.heytrove.ai/reference/api/upload.md): Use when you upload a PDF, EPUB or Markdown file over HTTP: check for duplicates, get an upload URL, send the file, then confirm so Trove starts the import.
- [Reports API](https://docs.heytrove.ai/reference/api/reports.md): Use when you read your personal value report over HTTP, page through its research sessions, or open and close the research sessions that the report is built from.
- [Teams API](https://docs.heytrove.ai/reference/api/teams.md): Use when you manage a team library over HTTP: list teams, invite and remove members, manage departments, and share books with the whole team or chosen departments.
- [Account API](https://docs.heytrove.ai/reference/api/account.md): Use when you read or change your settings, turn Trove off for one coding agent, report which agents a machine has, read notifications, or send a bug report over HTTP.
- [MCP server](https://docs.heytrove.ai/reference/mcp.md): Use when you connect Claude, ChatGPT or any MCP client to your Trove library, and need the server address, sign-in options, scopes, the research workflow, every tool and the limits.
- [API keys](https://docs.heytrove.ai/reference/api-keys.md): Use when you create, store or revoke a Trove API key, need to know what a key can do, or want to choose between an API key and an OAuth connector token.
- [Plans and limits](https://docs.heytrove.ai/reference/plans-and-limits.md): Use when you need to know what the Personal (free) and Professional plans allow, such as books, monthly reads, manuscripts and upload size, and what an agent should do when it reaches a limit.
- [For agents](https://docs.heytrove.ai/reference/for-agents.md): Use when an agent must fetch these docs as Markdown: the llms.txt index, the full-docs file, the .md twin of every page, and Accept-header negotiation.

## Optional
- [Full docs](https://docs.heytrove.ai/llms-full.txt): Every page in one file. Large; load only when you need the whole site.