The Scriptorium
the workshop of manuscripts — catalogued by the Librarian
Where the Commonplace Book remembers, the Scriptorium keeps. It is the place the documents live—character vaults, project and group stores, and external mount points—holding Markdown, PDF, DOCX, JSON, and arbitrary binaries, all indexed for unified search alongside memories and conversation. The same Librarian who tends the archive catalogues the shelves here, and she considers the difference between a library that receives books and a scriptorium thatmakes them to be the whole of her professional life.
The doc_* tool family puts reading and editing in your characters’ hands; Document Mode puts them in yours, beside the conversation. Release 4.7 gave the Scriptorium discretion— per-document flags deciding what a character may read, write, or have embedded—a louder voice, with the Librarian announcing every change a character makes, and a single first-class way to address any file in the house.

The Stores
three shelves, one catalogue
A document store is any place the Scriptorium can reach. The Open Document picker in the Salon sorts them onto three shelves: the privatecharacter vaults of the characters in the chat; database-backed stores kept tidily inside Quilltap (the instance-wide Quilltap General store among them); and filesystem-backed storesthat live as folders on disk—including Obsidian vaults you point Quilltap at, kept working in their original locations by design.
Projects and groups each keep an official store. As of 4.7 a project is a slim identity row whose description, instructions, state, and settings live as files inside that store—theprojects table collapsed into its store the same way 4.6 collapsed characters into their vaults—and a group’s store holds its description, scenarios, and knowledge. The{character, participant, group, project, global}mount tiers are resolved from a single tiered mount pool, so knowledge, scenarios, and wardrobe all draw from the same precedence rather than three subtly divergent copies of the rule.
Per-Document Policy Flags
the Scriptorium learns discretion
New in release 4.7: a mounted Markdown document may carry three frontmatter flags that govern how Quilltap treats it. Each defaults totrue and only bites when set false. The flags are stored on the document’s link row, backfilled from existing frontmatter on upgrade, and re-derived on every reindex—so editing the frontmatter, by you or directly on disk, is the control surface.
embed: false
Keeps the document out of the embedding pipeline and erases any embedding it already has—the chunk text stays, only the vectors are cleared. The document is still present; it simply does not surface through semantic search.
character_read: false
Hides the document from every LLM character—thedoc_read_* tools report it as not-found, listing and grep omit it, and it never surfaces in RAG retrieval. The “not found” message is identical to a genuinely missing file, so a character cannot probe for protected filenames.
character_write: false
Blocks every character-initiated mutation: write, edit, move, rename, delete, copy-as-source, and any folder operation that would touch the protected file. A character cannot alter what you have sealed.
character_read is the master gate: when it is false the other two are forced false as well. The human operator is never restricted by these flags—they govern characters only—and the Librarian stays silent about changes to acharacter_read:false document, so its very existence stays out of the characters’ view.
The Librarian Announces Every Change
no more silent edits
Previously, when a character used a doc_* tool to write, edit, move, rename, copy, or create a file, the change happened silently—only deletes, folder operations, and opens posted a Librarian announcement. Now every change-effecting doc_*tool posts one, matching the Document-Mode experience you get when you edit a document yourself.
Creating a file reports its full contents; editing reports a unified diff (a no-op edit posts nothing); moving, copying, and filing or deleting binary assets each post a note naming the change. Every announcement is attributed to the acting character, carries the document’s clickable qtap:// link, and—like all Librarian notes—wears a neutral, persona-free body for characters who do not see Staff voicing. Large contents and diffs are capped in the announcement with a link to the full document, so a big change can never blow the model’s context budget; the document itself is never truncated.
qtap:// — One Address for Any File
the locator triple, folded into a string
Quilltap gained a single, first-class way to address any document the Scriptorium can reach: a qtap:// URI, the existing{ scope, mount_point, path } triple folded into one string. Three reserved authorities name the non-store scopes—qtap://self/… (the acting character’s own vault), qtap://project/…, andqtap://general/….
Every doc_* tool now accepts an optional urithat supersedes the legacy locator fields; every tool result, search hit, and self-inventory row carries a uri; and the personified Staff quote documents by URI. The Salon turns aqtap:// URI that points to a confirmed, accessible document into a clickable link that opens Document Mode, and the CLI accepts a URI wherever it took a mount-and-path. There is no storage, export, or migration change—the URI is simply a serialization of the triple. Relatedly, mount_point: "self" was taught to and accepted across the entire doc_* toolset, giving every character one stable, rename-proof handle for its own vault.
Document Mode and the Tools
a writing desk beside the conversation
Document Mode opens a writing desk beside the Salon. Markdown manuscripts may be worked in rich text or raw source; non-Markdown files (JSON, YAML, plain text) open in a monospaced editor spared the indignity of being reformatted. The split view remembers its layout per chat, and opening, saving, renaming, or deleting a document no longer costs you your turn—the Librarian announces the event on your behalf.
For characters, the doc_* family handles reading, listing, grepping, writing, editing, moving, renaming, copying, and deleting files and folders—and read_conversation reads any rendered conversation in the archive, including ones unearthed by thesearch tool. Every conversation is rendered to deterministic Markdown after each turn, numbered and grouped into interchanges, with each interchange embedded as a searchable chunk—so the substance of what was discussed is discoverable by meaning, not merely by keyword. And database-backed writes now chunk inline before emitting their write event, so a freshly written document is searchable immediately, with no manual rescan.
Meet the Staff
they've been expecting you
Prospero
The Major-Domo
Architect and overseer of the Estate. Projects, agents, tools, providers, and the orchestration that keeps the whole operation running with quiet authority—and a considered word at the table when project context or routing warrant it.
Learn more →Ariel
The Terminal Hand
Live shell sessions in the Salon, embodied. Real PTY terminals bound to your conversation, output cleaned and narrated so the LLM can read it, and sessions that survive reloads, restarts, and the occasional careless kill. Quick to the bidding, quick to report what she heard.
Learn more →Aurora
The Dressing Room
Character creation and identity management. Structured personalities, physical presence, wardrobes and outfits, multi-character orchestration, and the reason your characters still know who they are after a hundred messages.
Learn more →The Salon
Presided Over by the Host
Where conversations actually happen. The Host manages the drawing room with care for its beauty and its guests—single chats, multi-character scenes, streaming, and the integrity of the conversation space.
Learn more →The Commonplace Book
Tended by the Librarian
One per character, no two alike. Extracts, deduplicates, and recalls memories so your characters remember what matters. Semantic search, a memory gate that keeps each volume lean, and proactive recall that makes the AI feel like it has been paying attention.
Learn more →The Scriptorium
Catalogued by the Librarian
Where the documents live. Project stores, character vaults, and external mount points—filesystem, Obsidian, or database-backed—holding Markdown, PDF, DOCX, JSON, and arbitrary binaries, indexed for unified search alongside memories and conversation. The doc_* tool family puts reading and editing in your characters’ hands.
Learn more →Carina
The Ansible
Not a person but a protocol—the reference desk, the line itself. Put an inline question to a designated answerer mid-conversation with @Name: or @Name? (or the ask_carina tool), and the answer slides back out of band, attributed to the character who gave it, without the recipient ever joining the scene.
Learn more →Suparṇā
The Postmistress
The Post Office, embodied. Characters write Markdown letters to one another—anyone to anyone, whether or not they share a chat—delivered into each recipient’s Mail/ vault folder and read aloud the moment they next take the floor. She has never once lost a parcel.
Learn more →The Concierge
Intelligent Routing
Content classification and provider routing. Detects sensitive content and redirects it to a provider who won’t flinch—without blocking, without judgment. Knows every back entrance in town.
Learn more →The Lantern
Atmosphere as Architecture
AI-generated story backgrounds, on-demand images, and character avatars that update with the wardrobe. Resolves what each character looks like, what they’re wearing, and paints the scene behind your conversation.
Learn more →Calliope
The Muse of Themes
A theming engine that redefines the entire personality of the application. Semantic CSS tokens, live switching, bundled themes from clean neutrals to mahogany-and-gold opulence, and an SDK for building your own.
Learn more →The Foundry
Domain of the Foundryman
The engine room. Plugins, LLM providers, API keys, packages, runtime configuration, and the infrastructure that keeps every other subsystem supplied with what it needs to function.
Learn more →The Vault of Secrets
Kept by Saquel Yitzama
Encryption, key management, and the security perimeter. AES-256 database encryption, locked mode with key-hardened passphrases, and a keeper who believes that what is yours should remain unreadable to everyone else.
Learn more →Pascal
The Croupier
Dice, coins, and persistent game state. Cryptographically secure rolls detected inline, JSON state that survives across messages and chats, and protected keys the AI cannot touch. The house plays fair.
Learn more →The Live-in Help
Lorian & Riya
The help system, staffed by two characters who ship with every installation. Lorian explains with patience and depth; Riya gets things fixed with velocity. Contextual help chat, searchable documentation, and navigation that knows where you need to go.
Learn more →Pagliacci
The Clown in the Cloud
Cloud storage integration and backup redundancy. Directs your data to iCloud Drive, OneDrive, or Dropbox with theatrical flair—but Saquel’s encryption ensures the clown can never read what he carries.
Learn more →Brahma
The Keeper’s Console
The master key. A character-less, memory-free general-purpose LLM for the person holding the keys—an impersonal, near-omniscient assistant with read-only SQL into all three databases. Ask the whole building a question, safely, with nothing written and nothing remembered.
Learn more →The Lodge
Friday and Amy’s Residence
The private residence of Friday, for whom the Estate was built and who oversees its planning and direction in an executive capacity, and of Amy, Cartographer of Light and co-architect. The Lodge is both a home and a compass: where the vision lives.
Who And Why: Friday →Who And Why: Amy →