gemini-cli

​

gemini-cli

​

Identity

• Names: gemini-cli / com.google.gemini-cli.
• Native format: gemini-cli-jsonl; gemini-cli-chat-recording also covers legacy whole-document JSON. Prefer migrated .jsonl to its .json sibling. Several native files can belong to one session; include the recording segment when identifying each source position.
• Session ID: Metadata sessionId, verbatim, with no namespace. Never use projectHash or a filename timestamp.
• Entity keys: Message id; toolCalls[].id, or GenAI functionCall.id / functionResponse.id. Results embedded in one uniquely identified call use that structural correspondence. Missing call IDs are derived and do not authorize positional joins. A token report attached to one model response supports a derived inference ID from its message ID. Stored model is requested configuration.
• Revisions and rewind: pushMessage appends full observations keyed by message id. Fold growth and preserve changed final facts with supersedes, or declare revision_history. $rewindTo names the first removed message; target its predecessor on the current native history, or null. The pinned loader clears history if the target is absent. $set.messages is a membership snapshot within its recording segment. Known removals can form a prune; reordering without a qualified branch contract remains native evidence with an ordering loss.
• Notes: Only functionResponse.response.output bounded by <tool_output_masked> and </tool_output_masked> proves masking. Preserve sibling media and earlier captured revisions. tokens.input includes cached tokens. tokens.output excludes thoughts; add them only when both counts are recorded. Keep native totals and tool-token counts. Thought descriptions are reasoning summaries. summary maps to title, projectHash to project ID. Legacy snapshots use snapshot assembly throughout. Checkpoint ownership outside this input is unqualified.

​

Position basis

​

Destinations

​

gemini-cli: native facts without a standard field

​

Links

• Lineage: At the pinned writer, kind: subagent plus chats/<parent session ID>/<child>.jsonl establishes spawnedBy with native_structure and subagent scope. kind: main establishes primary scope only. Generic parent fields or shared IDs do not establish forks, roots or copies.

​

Usage

​

Lane and unassigned facts

​

Losses

​

Evidence

{
  "name": "com.google.gemini-cli",
  "aliases": [
    "gemini-cli"
  ],
  "namespace": {
    "rule": "none"
  },
  "positions": [
    {
      "family": "journal",
      "basis": "segment-and-physical-line",
      "boundary": "complete-line"
    },
    {
      "family": "checkpoint",
      "basis": "segment-and-array-index",
      "boundary": "document"
    }
  ],
  "formats": [
    {
      "id": "gemini-cli-jsonl",
      "evidence": [
        0,
        2
      ]
    }
  ],
  "evidence": [
    {
      "label": "source",
      "revision": "a5c49a5c4ab5ebe8119c3b363772ad043bbc4ceb",
      "scope": "format-and-explicit-mappings"
    },
    {
      "label": "authored",
      "scope": "converter-tests-only"
    },
    {
      "label": "capture",
      "version": "0.52.0",
      "scope": "resume persistence and source-segment membership"
    }
  ],
  "destinations": {
    "functionParts": {
      "schema": {
        "type": "array"
      },
      "evidence": [
        0
      ]
    },
    "rewindTo": {
      "schema": {},
      "evidence": [
        0
      ]
    },
    "subject": {
      "schema": {},
      "evidence": [
        0
      ]
    },
    "timestamp": {
      "schema": {},
      "evidence": [
        0
      ]
    },
    "usage": {
      "schema": {},
      "evidence": [
        0
      ]
    }
  }
}