GRIMOIRE

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.

KeyCan do
GRIMOIRE_KEYEverything — capture, edit, delete. Yours only.
GRIMOIRE_READONLY_KEYSearch and ask only. Safe to share.
Never give another AI your full 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.

One-time setup (you do this)

1From the Grimoire repo folder, set the read-only key:
npx wrangler secret put GRIMOIRE_READONLY_KEY
2Paste any value you like when prompted — it doesn't need to match your main key.

What to give the other AI

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.

Revoking access

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.

← back to the library