letting another AI borrow the library
Grimoire's API is locked behind a key. There are two kinds — hand out the right one depending on what the other AI needs to do.
| Key | Can do |
|---|---|
GRIMOIRE_KEY | Everything — capture, edit, delete. Yours only. |
GRIMOIRE_READONLY_KEY | Search and ask only. Safe to share. |
GRIMOIRE_KEY.
It can delete every entry with one call. Set up the read-only key below instead
— it can't capture, edit, or delete anything.
npx wrangler secret put GRIMOIRE_READONLY_KEY
Paste this to Claude, ChatGPT, or any tool that can fetch a URL:
URL: https://grimoire.fromabc.xyz/api/entries?q=SEARCH_TERM
Header: x-grimoire-key: YOUR_READONLY_KEY
Also available:
POST https://grimoire.fromabc.xyz/api/ask
body: {"question": "..."}
→ semantic search across the whole library, answers in plain language
Any call to /api/capture, or a PATCH/DELETE
on an entry, is rejected with the read-only key — even if the other AI tries it.
Rotate the key any time by running wrangler secret put GRIMOIRE_READONLY_KEY again
with a new value — the old one stops working immediately, no need to tell anyone you shared it with.