Documentation
.aal — the All-AI Language
A portable context format. .aal stores your memory and context as a single, model-agnostic file, so meaning transfers losslessly between any AI — the substrate beneath Context Fidelity™.
What it is
.aal is a file format for AI context. Instead of leaving your memories, decisions and relationships trapped inside one tool, .aal serialises them into a single file you own — one that any model can read and write.
- Model-agnostic. Written once, read by GPT, Claude, Gemini, Grok or local models.
- Complete. Carries memories, entities, relationships and context packs together.
- Durable. Survives model swaps, session restarts, device changes and agent handoffs.
- Diff-friendly. Human-readable text — version your knowledge like code.
Anatomy of a .aal file
A file opens with header directives (@ lines) that describe its origin and
portability, followed by typed blocks — memory records and
context.pack definitions.
@aal 1.0
@origin claude-opus-4
@fidelity 0.98
@portable true
memory "cafe-startup-idea" {
type: idea
created: 2026-03-14
entities: [#cafe, #startup, #ai-infra]
summary: "A café that doubles as an AI workspace."
links: ~funding, ~market-research
}
context.pack {
recall: semantic("startup ideas about cafés")
include: [decisions, notes, files]
budget: 8k
}Header directives
| Directive | Meaning |
|---|---|
| @aal | Format version the file conforms to. |
| @origin | The model or tool that produced the file. |
| @fidelity | Context Fidelity™ score recorded at write time. |
| @portable | Whether the file is safe to move between models. |
This page documents a draft of the format for illustration. The published .aal specification — full grammar, block types and tooling — will live here as it's finalised.