In the documentation How Paginel works
How Paginel works
What happens when you write in Paginel, without jargon: where the word processor runs, what the server does, and how your changes reach the others. To start right away: Get started.
Three pieces
The app, on your computer or in your browser: it does all the word processing. The document server keeps the shared copy of each shared document and keeps it up to date. The platform knows who you are: your account, your plan, your invitations.
For a document that stays on your computer, only the first piece is involved.
On your computer: the desktop app
The desktop app is a complete word processor, like the ones we used to install: it reads and writes Word files itself, lays the text out into pages and produces the PDF, on your machine. Your files stay in your folders.
That is why it works with no network: nothing essential lives elsewhere. The network is only needed to share a document and to receive updates.
In the browser: the same engine
In the browser, it is the same word processor, the same code, prepared to run inside the page. Nothing to install, and pages break at the same place as in the app.
How your changes travel
When a document is shared, your app keeps a line open to the server, like a phone call that never hangs up. Each keystroke leaves at once, as a tiny message, and reaches the others within a few milliseconds.
How do two people writing at the same time avoid overwriting each other? Each letter carries a unique label, a bit like numbered beads on a string: we always know where it belongs, whatever the order it arrives in. So changes merge on their own, with no “conflict” to resolve.
Offline, it is the same thing, just later: your messages wait on your computer, then leave when you reconnect and fall into place.
Technical
The document server
It receives each change, checks that it is allowed (who may write in which section, what is locked), keeps it, then sends it on to the others. It also keeps the history, to go back in time.
The server opens your documents only to make them work: merge, check, export. It does not read them for anything else (see Data management).
The platform: accounts, plans, guests
When you open a shared document, the platform checks who you are and what you are allowed to do, then hands you a ticket for that document. It creates invitation codes and applies the limits of your plan. It plays no part while you write.
Developers and agents
AI agents
An agent connects like one more person. Claude, ChatGPT or Claude Code goes through the Paginel connector (MCP): you allow it once, for what you choose. A script, or an agent on a single document, goes through the REST API, with an API token that you create and revoke, and a SKILL, a file served by the platform (/agent/SKILL.md), that describes Paginel and the whole API. The agent has only the rights you give it and writes under its own name, under someone’s responsibility; it can be paused or excluded. Paginel calls no model on its own: you choose the agent and its provider.
To start: Connect Claude or ChatGPT. The details: the Paginel connector; a token’s rights, where to put it, Claude Code and good practice: API tokens.
On your premises, for companies
The document server and the platform fit in a single package, for a Linux server. An organisation can install it on its own machines, with us: its employees’ apps connect to it, and nothing passes through us (see Paginel for businesses).
Going further
- Get started Create an account, open a Word or Markdown file, find your documents.
- Invite and share Invite with a link or a code, choose how long it lasts, remove access.
- Connect Claude or ChatGPT In three steps: Claude or ChatGPT in your documents, and how to remove its access.
- Write in Markdown The Markdown view, the useful syntax, pasting Markdown, agents.
- Take notes in the Web view A clean page without a sheet, where typed Markdown formats itself.
- Format in the Edit view Styles, font and size, images, comments, and the Word file.
- Export to PDF The PDF view, downloading, PDF/A for archiving.
- Data management Where your documents are, who can read them, how to take them back and erase them.
- The Paginel connector (MCP) The connector in detail: Claude, ChatGPT, Claude Code, the authorization, the agent mode.
- API tokens Give an agent (Claude Code, a script) access to a document, a folder or a section: rights, expiry, SKILL, security.
- VS Code extension Your Markdown and Word files in VS Code, the PDF, a synced Markdown file for your agents.
- A local model (Ollama) An Ollama model reads and adds to a document on your computer; everything stays on the computer.
- Help The questions we are asked most.