What fits in the file?
An AI character travels in many files — a card, a Markdown soul, an avatar, a memory bundle. One table of what each of them carries, and what it drops on the way.
An AI character travels in many files — a card, a Markdown soul, an avatar, a memory bundle. One table of what each of them carries, and what it drops on the way.
Nobody chose this. Role-play apps settled on the character card; agent frameworks on Markdown files; VTubers on VRM; memory projects on their own bundles. Each format is good at its layer and blind to the others, so a character that lives in several places exists as several files that drift apart. COF is the container that holds them together — a ZIP with a manifest, open, with rules about ages, rights and consent. This page compares it with the formats it embraces, feature by feature, including the ones COF does not have.
Seven formats, as published: Character Card V2 (the chara PNG and its JSON, the de-facto standard of SillyTavern and its kin), Character Card V3 / .charx (its 2024 successor, a ZIP with assets), agent Markdown (SOUL.md, IDENTITY.md, AGENTS.md as OpenClaw and Hermes read them), Letta Agent File .af (a serialized stateful agent), MacPaw Portable Memory .mem (a user-owned memory bundle, 2026) and VRM 1.0 (the humanoid avatar on glTF, with the only mature permission block). Read as columns: what a file in that format can say about a character on its own, without the application that made it.
| Feature | COF1.2 · ZIP + manifest · spec CC BY 4.0, tools MIT | Character Card V2PNG tEXt / JSON · 2023 · SillyTavern & co. | Character Card V3 / .charxJSON, PNG or ZIP · 2024 · MIT | Agent MarkdownSOUL.md, IDENTITY.md, AGENTS.md · OpenClaw, Hermes | Letta Agent File.af JSON · Apache-2.0 | MacPaw Portable Memory.mem bundle (JSONL) · 1.1 · MIT | VRM 1.0GLB + VRMC_vrm · humanoid avatar |
|---|---|---|---|---|---|---|---|
| The character | |||||||
| Text personalitydescription, prompts, scenario | ✓a Character Card V3 inside, plus free text | ✓ | ✓ | ✓free Markdown | ✓persona block | ~a core / persona item, text | ✕ |
| Example dialogue and greetings | →in the embedded card | ✓ | ✓plus group greetings | ✕ | ✕ | ✕ | ✕ |
| Lorebook / world infoentries triggered by keywords | →in the embedded card, or lorebook.json | ✓ | ✓decorators, regex | ~plain files the agent may read | ~blocks and sources, no triggers | ✕ | ✕ |
| Several presets from one filework / all audiences, ages, languages, styles | ✓named combinations with their own age and coherence report | ✕one file per version | ✕ | ✕ | ✕ | ✕ | ✕ |
| Several characters in one filea cast, with relations | ✓identities, relations declared once, inverses computed | ✕ | ~group greetings only | ✕ | ~groups of agents, no relations | ✕ | ✕ |
| Gender, nickname, archetype, narrative role | ✓RFC 0003 | ✕ | ~nickname | ~free text | ✕ | ✕ | ✕ |
| Languagesthe same character in several languages | ✓per-language text in cards, gists and nodes; tools in six languages | ✕ | ~multilingual creator notes | ✕ | ✕ | ✕ | ✕ |
| Looks and body | |||||||
| COF | Character Card V2 | Character Card V3 / .charx | Agent Markdown | Letta Agent File | MacPaw Portable Memory | VRM 1.0 | |
| Reference images: face, body, anglesseveral views, character sheets | ✓views with subject, angle, framing, style; sheets with regions | ✕the PNG is the only picture | ~icon, background, user icon | ~an avatar path or URL | ✕ | ✕references only, no bytes | ~a 1024² thumbnail |
| Expressions | ✓expression images, tagged | ✕ | ✓emotion sprites, named | ✕ | ✕ | ✕ | ✓18 presets, incl. visemes |
| Outfits | ✓outfit variants, per preset | ✕ | ✕ | ✕ | ✕ | ✕ | ✕ |
| 3D modelVRM, GLB, splats, printable mesh | →kept as a file, with textures declared, plus prints and splats | ✕ | ~a 3d/ folder, no schema | ✕ | ✕ | ✕ | ✓it is the model |
| Rig and facial deformation | →whatever the carried VRM / GLB defines | ✕ | ✕ | ✕ | ✕ | ✕ | ✓humanoid bones, spring bones |
| Poses and motionOpenPose, clips, motion signature | ✓posture library, clips with rig and fps, LMA attitude | ✕ | ✕ | ✕ | ✕ | ✕ | ~VRMA animations are a separate file |
| Voicesamples with transcript, voice profile | ✓samples, transcripts, profile, engine artifacts, cloning permission | ✕ | ~an audio/ folder, no schema | ✕ | ✕ | ✕ | ✕ |
| Identity weightsLoRA, reference latents, with their base model | ✓safetensors only, base model mandatory, sources kept | ✕ | ~an ai/ folder, no schema | ✕ | ✕ | ✕ | ✕ |
| Memories and inner life | |||||||
| COF | Character Card V2 | Character Card V3 / .charx | Agent Markdown | Letta Agent File | MacPaw Portable Memory | VRM 1.0 | |
| Memories as dated eventswhen, where, with whom, how it felt | ✓RFC 0002: moments and periods, age or date, feelings then and now, clarity | ✕ | ~lorebook entries, undated | ~a MEMORY.md of day notes | ~text blocks with a size limit; no passages | ✓episodes: eventTime, actors, importance | ✕ |
| Media attached to a memory | ✓images, sound, short video, inside the file | ✕ | ✕ | ✕ | ✕ | ~a reference and a hash, no bytes | ✕ |
| Links between memoriesbefore / after, part of, same event, because | ✓ | ✕ | ✕ | ✕ | ✕ | ✓typed links with a weight | ✕ |
| A psyche: values, beliefs, wants, fearseach with a strength, a stability, a span | ✓RFC 0004: a graph of nodes | ✕adjectives in prose | ✕ | ✕prose | ✕prose in the persona block | ~facts with a validity span, no kinds | ✕ |
| The reason behind a convictiona fear points to the memory that made it | ✓because links from nodes to memories | ✕ | ✕ | ✕ | ✕ | ~lineage of a fact to its episodes | ✕ |
| Timethe character at 20 and at 45 | ✓since / until on nodes, periods on memories, age per preset | ✕one snapshot | ✕ | ✕ | ✕ | ~valid-from / valid-to on facts | ✕ |
| People, places and objectsnamed once, shared by memories and psyche | ✓RFC 0005 | ✕ | ✕ | ✕ | ✕ | ~entities and edges, derived | ✕ |
| Visibility and disclosurecanon vs personal; secret, guarded | ✓purged on export; secrets left out of agent exports by default | ✕ | ✕ | ✕ | ✕a block is read whole | ~a free sensitivity string; scope RFC pending | ✕ |
| Write-back of what was livedthe host adds memories to the file | ✓cof memory add, from OpenClaw or Hermes notes, idempotent | ✕ | ✕ | ~the agent writes notes, nothing imports them | ✓the agent state is the file | ✓ingestion with provenance | ✕ |
| Agent skillsSKILL.md and its files | ✓files library, kind skill | ✕ | ✕ | ✓skills/ folder | ✓skills[] | ~procedures | ✕ |
| Rights and safety | |||||||
| COF | Character Card V2 | Character Card V3 / .charx | Agent Markdown | Letta Agent File | MacPaw Portable Memory | VRM 1.0 | |
| Permissions on the charactercommercial use, redistribution, training, voice cloning | ✓permissions in the manifest, applied by the tools | ✕creator and tags | ~creator, source | ✕ | ✕ | ✕ | ✓the meta block: 14 permission fields |
| Licence per asset | ✓SPDX per asset | ✕ | ✕ | ✕ | ✕ | ✕ | ~one licence URL for the model |
| Real-person consentrecord, scope, proofs, revocation | ✓rights/ folder; intimate scope and voice cloning need it | ✕ | ✕ | ✕ | ✕ | ✕ | ~avatar permission: author only, explicit, everyone |
| Declared age and minor protection | ✓age per preset; nudity or intimate content with a minor = invalid file | ✕ | ✕ | ✕ | ✕ | ✕ | ~sexual usage switch, no age |
| Content tags and audiences | ✓tags.content, all-audiences export, intimate never neutral | ~tags | ~tags | ✕ | ✕ | ~sensitivity | ~violent / sexual usage flags |
| Provenancecreated, modified, source, AI-generated | ✓append-only source[], dates, IPTC digital source type, C2PA sidecar | ✕ | ✓source[], creation and modification dates | ✕ | ✕ | ✓typed provenance on items | ~authors, copyright |
| Integrityhashes, no executable content | ✓sha256 per asset, pickles refused, executables declared or refused, safe paths | ✕ | ✕a code/ folder is allowed | ✕ | ✕ | ✓CHECKSUMS, tombstones, audit log | ✕ |
| Signatures | ~optional manifest signature in the spec (JWS); no tool signs yet | ✕ | ✕ | ✕ | ✕ | ✓optional Ed25519 | ✕ |
| Tooling and interchange | |||||||
| COF | Character Card V2 | Character Card V3 / .charx | Agent Markdown | Letta Agent File | MacPaw Portable Memory | VRM 1.0 | |
| Open specification with schemas and a validator | ✓spec, JSON Schemas per version, cof validate | ~a spec, no validator | ~a spec and TypeScript types | ✕conventions | ~Pydantic models in the SDK | ✓spec, schemas, mem validate | ✓spec, schemas |
| Unknown fields survive a round trip | ✓x- keys and categories kept by cof-cli and the builder | ~extensions | ✓extensions, SHOULD keep | ✓it is text | ✕no version field, migrations pending | ✓ext on episodes | ✓glTF extras |
| Imports the others | ✓V2 / V3 PNG and JSON, Character.AI exports, OpenClaw and Hermes notes | ✕ | ✓V2 | ✕ | ✕ | ✕ | ✕ |
| Exports to the others | ✓ccv3 PNG, card JSON, SOUL.md / IDENTITY.md, agent workspace, Hermes profile | ✕ | ✓PNG, JSON, CHARX | ✕ | ✕ | ✕ | ✕ |
| Self-describing filea note inside that says what it holds | ✓COF.md written in every file | ✕ | ✕ | ✕ | ✕ | ~manifest | ✕ |
| Reference tools, offline, in a browser | ✓builder, explorer, cof-cli, ComfyUI nodes | ✕apps | ✕apps | ✕agents | ✕a server | ~SDKs | ✕viewers |
| Fits in a single PNG | ✕it exports one | ✓ | ✓PNG or APNG | ✕ | ✕ | ✕ | ✕ |
| Runs the agenttools, rules, model config, history | ✕by design: executableContent none | ✕ | ~scripts in extensions | ✕ | ✓ | ✕ | ✕ |
| Planned for COF | |||||||
| COF | Character Card V2 | Character Card V3 / .charx | Agent Markdown | Letta Agent File | MacPaw Portable Memory | VRM 1.0 | |
| Psyche carried by the card exportthe PNG and .charx exports render the psyche as text | ○1.2.3 · 29 Nov 2026 | ✕ | ✕ | ✕ | ✕ | ✕ | ✕ |
| .charx export and import | ○1.2.3 (cof-cli) · 1.4 (builder) | ✕ | ✓it is .charx | ✕ | ✕ | ✕ | ✕ |
| Weighted selection of memories and nodeswhat the model receives for this moment, specified for every host | ○1.2.3 | ✕ | ✕ | ✕ | ✕ | ✕recall is the service's, not the file's | ✕ |
| A reference playerconverse, pick, illustrate, write the lived back into the file | ○1.2.3 | ✕ | ✕ | ✕ | ✓a Letta server | ✕ | ✕ |
| Assisted and automatic creationfrom a few lines, with the user's own API key, or a free starter kit of placeholder media | ○1.2.3 | ✕ | ✕ | ✕ | ✕ | ✕ | ✕ |
| A public gallery of starter charactersCC BY 4.0, adults and non-humans only | ○1.2.4 · December 2026 | ✕ | ✕ | ✕ | ✕ | ✕ | ✕ |
| Relations with an end, a reference date for the canon, spoken languages | ○1.3 · January 2027 | ✕ | ✕ | ✕ | ✕ | ✕ | ✕ |
| A professional profilejob sheet, knowledge, signed skills, data policy, AI disclosure | ○1.3 · January 2027 | ✕ | ✕ | ✕ | ✕ | ✕ | ✕ |
| Tile and table views in the tools | ○1.4 · February 2027 | ✕ | ✕ | ✕ | ✕ | ✕ | ✕ |
| Signatures and certificationan attestation on the canonical manifest | ○2027 | ✕ | ✕ | ✕ | ✕ | ✓optional Ed25519 | ✕ |
Hover a mark to read its note. A green mark means the format defines the thing; whether a given application uses it is another matter — most apps read a fraction of any format, COF included.
Fit in a single PNG
A card is a picture you can post anywhere, and it stays a picture. A .cof is an archive. It exports a ccv3 PNG (and soon a .charx), but the file itself needs a tool that opens ZIPs — every tool does.
Run the agent
Letta's .af ships the tools, the tool rules, the model configuration and the message history. COF ships the character and declares executableContent: none. What runs it is the host's business, on purpose.
Define a rig
VRM defines the bones and the expressions. COF carries a VRM or a GLB as a file, with its rights and its textures, and adds the poses, the clips and the voice around it. The rig stays VRM's.
Prove a deletion
MacPaw's .mem writes tombstones and an audit log, so a forgotten memory can be shown to have been forgotten everywhere. COF purges on export (cof extract) and keeps no trace of it — yet.
Presets
One file, several ready-to-use combinations: the same character at 29 and at 65, for work and for everyone, in French and in Japanese. Other formats need one file per version, and the versions drift.
A past and an inner life, with a why
Dated memories with who, where, what and how it felt; a psyche of values, beliefs, wants and fears, each tied to the memory it comes from, with a strength and a time span. Agent formats keep prose; memory formats keep events; neither keeps the link between the two.
Rules a validator enforces
Every preset declares an age; nudity or intimate content with a minor makes the file invalid, not merely tagged. A real person needs a consent record. Executables, pickles and unsafe paths are refused. Nobody has to trust the author's good faith.
Write-back from the host
What the character lived in OpenClaw, in Hermes or in a chat comes back into the same file as new, personal memories (cof memory add) — and leaves with the user. One character, two homes, one memory.
The point of the table is not that COF wins the most ticks. It is that COF does not ask anyone to abandon anything: a .cof contains a valid Character Card V3, exports a ccv3 PNG, a card JSON, SOUL.md / IDENTITY.md and a whole agent workspace, and keeps a VRM as a plain file. The formats in the other columns are its inputs and its outputs. Where COF has no equivalent — a rig, a runtime, a signed deletion — the right move is to carry the other format, and the table says so with a →.
The grey rows are promises with a date, not features. They come from the public roadmap; the RFCs that change the format are open for comments before they ship.
chara_card_v2 specification (SillyTavern, Risu, Chub) and its PNG tEXt chara embedding.SPEC_V3.md (MIT): assets, creator_notes_multilingual, source[], dates, group_only_greetings, the embeded://assets/ folders.SOUL.md / IDENTITY.md, Hermes Agent profiles, the AGENTS.md convention; what COF writes is documented in the 1.2.2 notes.AgentFileSchema of the letta package: agents, groups, blocks, files, sources, tools, mcp_servers, skills; no passages, no format version field.CHECKSUMS, optional Ed25519 signatures; RFC 0001–0003 towards 1.2.meta permission block (avatar permission, violent and sexual usage, commercial use, redistribution, modification, credit).