The .gram
file
Knowledge changes. A .gram file keeps what is true now and every earlier version of it, in one plain-text file you own. People edit it in Thegram, AI agents write to it over MCP, and anyone can open it as a document, a dashboard, a graph or a timeline.
01 · What is inside
One document,
many facts
One .gram file is one document. It is plain UTF-8 text: the current version comes first, and the history follows in the same file.
A document you can read
A title and a body written like Markdown: headings, lists, tables, quotes, code, math and diagrams. The body places records where they belong in the story.
Typed records
Decisions, tasks, risks, blockers, events, metrics, sources, requirements, assumptions, goals, people, components and more. Each has a title and, where it applies, a description, status, priority, owner, tags, sources and a link to where it came from.
Links with meaning
Records connect as supports, contradicts, depends on, implements, replaces, blocks, enables or part of. A link can point into another .gram document, so many files read as one graph.
Dates that matter
Events carry when they happened, tasks their due date, and metrics when they were observed, so a file can answer what happened in March without a separate calendar.
02 · Every revision
Knowledge
changes
Every change is saved as a new revision, with when it was written and who wrote it, chained by hash to the one before. Nothing is overwritten and nothing is lost.
Step back in time
Step back through the revisions and the document, the dashboard and the graph show that day. Play forward to watch the work unfold.
When it happened, when it was known
A fact written today can be about last month. The file keeps both times, so you can ask what was true then and what was known then.
What changed, and why
History lists each revision with what changed. A decision that was replaced stays in the file, marked superseded, next to the one that replaced it.
Safe with many writers
Each write names the revision it was based on. A write based on an old revision is refused instead of overwriting, so people and agents never silently erase each other's work.
03 · Where it opens
One file
everywhere
Keep a .gram file in a folder on your Mac, in the Files app on iPhone and iPad, in a Thegram Cloud vault you share with a team, or in your Google Drive. Search indexes and graphs are built from the file and can be rebuilt any time; the file is the original.
Thegram for Mac
Create and edit .gram files as a dashboard, a document, a graph and a history, and search across every folder, vault and Google Drive at once. Install for Mac
Thegram for iPhone & iPad
Read the same files with their dashboard, every past revision, the graph and search. In beta on TestFlight. Join the beta
In the browser
Drop a .gram on viewer.thegram.one to read it without an account; nothing is stored. Sign in at vault.thegram.one to keep files in vaults.
Your AI agents
Claude Code, Codex, OpenCode, OMP and ChatGPT read and write .gram files as their memory over MCP. Agent memory
04 · Questions
Questions
Still unsure? Email support@thegram.one.
How do I open a .gram file?
Drop it on viewer.thegram.one to read it in any browser without an account, or open it in Thegram for Mac, iPhone and iPad, or in the web app at vault.thegram.one.
Is it a database?
No. It is one file. Its history lives inside it, so copying the file copies every revision. Apps build search indexes from it and can always rebuild them.
How is it different from a Markdown note?
A note keeps only its latest text. A .gram file also knows which lines are decisions, tasks or risks, what state they are in, how they connect, and what the file looked like at every earlier revision.
Who owns my files?
You do. A .gram file stays where you keep it, on your device, in your vault or in your Google Drive.
What does it cost?
Thegram is free.
Open your
first .gram
Try a file in the browser, or install Thegram and let your agents start one.
- viewer.thegram.oneopen a file, no account
- Install guideMac, iPhone and ChatGPT
- Agent memoryClaude Code, Codex, ChatGPT