file format · open · portable
AI sounds like
everyone. It should
sound like you.
A .idiomark file captures how a person speaks and
thinks — voice, tone, writing patterns, values, cognitive style — so AI systems
can sound like that person and understand them, instead of sounding generic.
; jordan.idiomark [voice] tone = direct, dry hedging = low [writing] sentence = short. fragments welcome. emoji = never [values] candor = core brevity = core
Models generate beige.
Prompting for a persona every time doesn't scale and doesn't travel — what works
on one model drifts on another. A .idiomark file is a durable,
versioned, portable personality profile that any system can consume.
One file. Every model. Still you.
Write it once. Carry it everywhere.
-
01
Describe
Capture voice, tone, writing patterns, values and cognitive style in plain, human-readable INI. No lock-in, no black box.
-
02
Validate
The loader and validator check your profile against the stable v1 schema — v2 features ship experimentally alongside, never breaking readers.
-
03
Apply
Hand the file to any consumer — SDK, CLI, MCP server, inference layer — and responses come back sounding like the person it describes.
The toolkit.
- @idiomark/core Schema, loader, reader, validator, generator ↗
- @idiomark/sdk High-level API for consuming profiles ↗
-
@idiomark/cli
idiomarkcommand-line tool ↗ - @idiomark/inference Apply a profile to AI responses ↗
- @idiomark/mcp MCP server exposing profiles to agents ↗
- @idiomark/projectors Project a profile onto tasks ↗
Open, versioned, pre-1.0.
MIT licensed. The stable core schema lives in spec/v1;
draft v2 — Big Five, linguistic markers, cognitive patterns — develops openly in
spec/v2.
Breaking changes are possible before v1 is locked.