COF· Character Open File · 1.2

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.

COF · CHARACTER OPEN FILE

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.

The table

✓ native: the format has a field or a rule for it~ partly: text only, an opaque file, or a convention without a schema✕ no→ carried: COF keeps the other format's file inside, unchanged○ planned for COF, with its version
FeatureCOF1.2 · ZIP + manifest · spec CC BY 4.0, tools MITCharacter Card V2PNG tEXt / JSON · 2023 · SillyTavern & co.Character Card V3 / .charxJSON, PNG or ZIP · 2024 · MITAgent MarkdownSOUL.md, IDENTITY.md, AGENTS.md · OpenClaw, HermesLetta Agent File.af JSON · Apache-2.0MacPaw Portable Memory.mem bundle (JSONL) · 1.1 · MITVRM 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
COFCharacter Card V2Character Card V3 / .charxAgent MarkdownLetta Agent FileMacPaw Portable MemoryVRM 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
COFCharacter Card V2Character Card V3 / .charxAgent MarkdownLetta Agent FileMacPaw Portable MemoryVRM 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
COFCharacter Card V2Character Card V3 / .charxAgent MarkdownLetta Agent FileMacPaw Portable MemoryVRM 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
COFCharacter Card V2Character Card V3 / .charxAgent MarkdownLetta Agent FileMacPaw Portable MemoryVRM 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
COFCharacter Card V2Character Card V3 / .charxAgent MarkdownLetta Agent FileMacPaw Portable MemoryVRM 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.

What COF does not try to do

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.

What only COF does, today

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.

Embrace, don't replace

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.

Sources