{
  "id": 565917,
  "title": "3. Qarinah: Evidence-linked project memory for coding agents Agent memory should return evidence, not just a story",
  "url": "https://urgent.news/2026/08/11/3-qarinah-evidence-linked-project-memory-for-coding-agents-agent",
  "topic": "tech",
  "section": "Tech",
  "published": "2026-08-11T13:09:13.000Z",
  "source": {
    "name": "Indie Hackers",
    "slug": "indie-hackers",
    "url": "https://e9527aec.click.convertkit-mail4.com/mvu696mvxa5hq4lpgzamhree03n5t3he800/n2hohvhvz9ggqei6hg/aHR0cHM6Ly93d3cuaW5kaWVoYWNrZXJzLmNvbS9wb3N0L2JTVnk4RHlINUZBTjR6TUZyMjJt"
  },
  "original_language": "en",
  "account": "The Qarinah project offers a novel approach to managing memory for coding agents. Rather than replaying every prior message, which can be cumbersome and impractical, Qarinah keeps an authoritative project record locally. Selected items from this record are compiled into a small context pack specifically for the current task.\n\nKey features of Qarinah include:\n1. An opt-in, append-only JSONL event chain for permitted project events and decisions, complete with event IDs and content hashes for traceability.\n2. Multiple view options for the context pack: rebuildable graph, SQLite, Markdown, and Open Knowledge Format.\n3. A bounded retrieval step that ensures evidence coverage or allows the agent to abstain when necessary.\n4. Cross-agent handoffs compatible with Codex, Claude Code, Cursor, the CLI, and MCP clients.\n\nPerformance benchmarks show the benefits of this approach. Testing with 240 project-history records across six software scenarios yielded a context compression rate of 98.7148%, reducing the estimated input-context tokens from 442,113 to just 5,682 (a 77.81:1 compression ratio). Importantly, every required target was directly covered in the top five results, with no additional model-written summary items.\n\nQarinah is licensed under Apache-2.0 and is currently at version 0.1.6. The open-source repository, along with a white paper, Zenodo concept record, and detailed benchmark method, are available for those interested in exploring or providing feedback on this innovative memory management technique for coding agents.",
  "summary": null,
  "key_points": [
    "Qarinah project introduces evidence-linked memory for coding agents",
    "Opt-in JSONL event chain with content hashes for traceability",
    "98.7148% context compression achieved with 77.81:1 token ratio"
  ],
  "editors_take": "Qarinah's approach to coding agent memory, emphasizing evidence over narrative, sets a new standard for efficient and reliable project record-keeping, likely benefiting developers reliant on accurate context.",
  "illustration": null,
  "coverage": {
    "outlets": 1,
    "also_reported_by": []
  },
  "ai_generated": true,
  "disclaimer": "Summaries, key points and the editor’s take are written by software from other outlets’ reporting and may contain errors — always check the linked original."
}