Skip to content

Add agent session notes as a context source #24

Description

@francozeta

Summary

Explore and add adapters for agent session notes from tools such as Codex, Claude Code, Cursor, and other local AI coding workflows.

Motivation

Developers lose context when switching sessions or after compaction. The most valuable context is often what the agent tried, what failed, what was decided, and what should happen next.

Proposed Direction

  • Define a local source contract for session notes and handoff files.
  • Support explicit folders first, for example .xepha/sessions/ or configured paths.
  • Avoid scraping private tool internals by default.
  • Preserve provenance so each note points back to its source file/session.

Acceptance Criteria

  • Document a neutral session-note format Xepha can ingest.
  • Add one local-file based adapter for session notes.
  • Context output distinguishes session notes from git commits and docs.
  • Privacy expectations are documented clearly.

Research Signal

Community discussions repeatedly mention saving plans, investigations, CLAUDE.md, and session notes as practical workarounds for context loss.

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:adaptersSource adapters such as git ingestarea:protocolContext pack schemas, codecs, and protocol boundarieshelp wantedExtra attention is neededpriority:p2Normal prioritytype:researchValidation, investigation, or design research

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions