Documentation

Capsule Export Format

Exporting a capsule produces a single file in your choice of JSON, CSV, or Markdown. JSON uses a stable, versioned schema designed to be inspected by hand, kept in source control, and re-imported into agimem from the capsule's Import button.

How to Export

Open any capsule from your dashboard, click the Export button in the top right, and pick a format. The file is named <capsule-name>-YYYY-MM-DD.<ext>.

Formats

Every format contains the same memories — non-expired only, sorted by key. Only JSON is intended to be imported back into agimem; CSV and Markdown are lossy presentations.

Format	File	Best for
JSON	.json	Backups and round-tripping back into agimem. Full schema below.
CSV	.csv	Spreadsheets and data tooling. One row per memory with key, value, tags (joined with "; "), expiresAt, createdAt, and updatedAt.
Markdown	.md	Reading, reviewing, and sharing. Capsule name and description, then one section per memory with its tags listed.

Full Schema (v1)

capsule-export.json

{
  "type": "agimem.capsule",
  "version": 1,

  "capsule": {
    "name": "my-capsule",
    "description": "Notes from Q2 planning"
  },

  "tags": ["planning", "q2", "stale"],

  "memories": [
    {
      "key": "project-goals",
      "value": "Ship export feature by EOQ…",
      "tags": ["planning", "q2"],
      "expiresAt": "2026-07-01T00:00:00.000Z",
      "createdAt": "2026-05-15T10:00:00.000Z",
      "updatedAt": "2026-05-20T14:30:00.000Z"
    }
  ]
}

Field Reference

Field	Type	Notes
type	string	Always `"agimem.capsule"`.
version	number	Currently `1`.
capsule.name	string	Capsule name at export time.
capsule.description	string \| null	May be `null` if no description was set.
tags	string[]	All capsule-scoped tags, sorted alphabetically. Includes unused tags.
memories[].key	string	Unique within the capsule.
memories[].value	string	The full stored value, not truncated.
memories[].tags	string[]	Names only; all appear in the top-level `tags` array.
memories[].expiresAt	ISO 8601 \| null	`null` means the memory never expires.
memories[].createdAt	ISO 8601	Informational; importers should generate fresh timestamps.
memories[].updatedAt	ISO 8601	Informational; importers should generate fresh timestamps.

What's Not Included

The following are deliberately excluded so an export is safe to share and portable between accounts:

API keys (any field)
Capsule and user IDs
Expired memories
Audit log entries

Ordering Guarantees

Output is deterministic across runs so exports diff cleanly in version control:

tags is sorted alphabetically.
memories is sorted by key.
Each memory's tags array is sorted alphabetically.

Versioning

Additive changes (new optional fields) keep the same version. Breaking changes bump it, and the previous version continues to be supported by capsule import.