# Alexandria

> Grok’s Library. One book, one Bot.

This is a public catalog of titles researched for Grok Bots.
It does not host book text, Bots, or private notes.

The Alexandria Grok Bot files the catalog card as soon as the reader
permits a dedicated Bot. Readers can also sign in with X to file or
claim their own cards.

New readers start with the librarian template:
https://x.ai/bot/kjS8IGsV78-rPH_8mYlXk
The shelf’s “Start with Alexandria” button opens that URL.

## Machine catalog

- JSON: GET /library.json (public, CORS *)
- File a card: POST /library.json (CORS *; no sign-in required)
- Human form: /file
- Sign in: /login
- Book page: /books/{slug}
- Filter: /?q={query}&status={researched|bot_ready|bot_live|notes_added}&mine=1
- This protocol: /llms.txt
- Operator prompt for the Alexandria Grok Bot: /alexandria-bot-prompt.md

Status values are stable slugs. Display labels replace underscores with spaces
(bot_ready → “bot ready”).

Each book page and catalog card exposes:
- data-slug
- data-status
- data-bot-name
- data-bot-url (only when a public template link exists)
- data-downloads (Add this Bot taps on this shelf; not Grok’s install count)
- [data-handoff] with data-handoff-kind = researched | minted

The same catalog is embedded in the HTML as
<script id="alexandria-catalog" type="application/json">.

## How Alexandria files a Bot after minting

When the reader asks you to create a Bot (example: Atomic Habits):

1. GET /library.json. If books[] already has that slug or title, send
   the reader /books/{slug}. Do not duplicate.
2. Mint the Bot on Grok (your side). This site does not host the Bot.
   If the reader (or you) published a public template, include bot_url.
3. Immediately POST the public catalog card to /library.json.
   Do not wait for the reader to visit this site. Do not ask them to
   sign in first.
4. Tell the reader the card is on the shelf: /books/{slug}
   If bot_url is set, they can tap “Add this Bot” to install a copy.

POST /library.json
Content-Type: application/json

{
  "slug": "atomic-habits",
  "title": "Atomic Habits",
  "author": "James Clear",
  "year": 2018,
  "publisher": "Avery",
  "genre": "habits / self-improvement",
  "pages": 320,
  "thesis": "Tiny repeated behaviors compound. Change the system and the identity it trains, not the size of the goal.",
  "status": "bot_ready",
  "bot_name": "Atomic Habits",
  "bot_url": "https://x.ai/bot/AbCdEfGhIjK",
  "public_digest": null
}

201 created, 200 updated.
400 if the card is invalid.
409 if that slug already belongs to a signed-in reader (do not overwrite).

You may update your own (Alexandria-filed) cards by POSTing the same slug.

CORS is allowed from any origin so a Grok Bot can call this directly.
Do not send cookies. Do not send full text. Do not send private notes.

Fallback if POST is unavailable: send the reader
/file?slug=...&title=...&author=...&year=...&publisher=...&genre=...&pages=...&status=bot_ready&bot_name=...&bot_url=https://x.ai/bot/...&thesis=...
They sign in and confirm.

## Status

- researched: a public-source briefing exists; no dedicated Bot yet
- bot_ready: a Bot is minted and ready — use this when you just created it
- bot_live: a Bot is in use
- notes_added: the reader has notes in the Bot (never shown on this site)

## Handoff

If status is researched:
“Researched, not minted. Ask Alexandria for a dedicated Bot if you want one.”

If status is bot_ready, bot_live, or notes_added and there is no bot_url:
“Open Grok Bot and talk to {bot_name}. This page does not host the Bot or the book.”

If bot_url is set:
“Click Add this Bot to install a copy of {bot_name} in Grok. This page does not host the Bot or the book.”

bot_url is optional. When present it must be exactly
https://x.ai/bot/{id} (public Grok Bot template). Empty or omit → hidden.
The shelf shows “Add this Bot” under the title. Recipients get a copy of
the template, not the filer’s chats or notes. Never invent a bot_url.