Skip to content

docs: reframe README around memory reliability, add differentiator#86

Merged
Siddhant-K-code merged 1 commit into
mainfrom
docs/readme-reframe-memory-reliability
May 9, 2026
Merged

docs: reframe README around memory reliability, add differentiator#86
Siddhant-K-code merged 1 commit into
mainfrom
docs/readme-reframe-memory-reliability

Conversation

@Siddhant-K-code

Copy link
Copy Markdown
Owner

What

Rewrites the README top section to lead with memory reliability instead of token reduction, and adds a one-sentence differentiator.

Why

The previous README led with "context preprocessing" and "fewer tokens sent." This positions Distill in a crowded category of compression tools. The actual value is that agents don't forget, don't re-learn, and don't operate on conflicting information — a reliability problem, not a cost problem.

Changes

  • Headline: "Your agent remembers what matters." replaces "Open-source context preprocessing for LLM applications."
  • Differentiator: Added near the top — "Other tools compress what goes into your agent. Distill controls what your agent remembers — across sessions, without conflicts, ranked by what matters now."
  • Problem statement: Reframed around agent forgetfulness and trust, not just redundancy percentages
  • How It Works table: Added "Remember" as the first stage
  • API docs: Added expire and supersede endpoints, updated MCP tools list

Closes #80
Closes #81

@Siddhant-K-code Siddhant-K-code added the documentation Improvements or additions to documentation label May 9, 2026
- Lead with 'Your agent remembers what matters' instead of token reduction
- Add one-sentence differentiator near the top
- Reframe the problem statement around agent forgetfulness and trust
- Add 'Remember' stage to the How It Works table
- Document new memory endpoints (expire, supersede) and MCP tools
- Move token efficiency to a supporting detail, not the headline

Closes #80
Closes #81

Co-authored-by: Ona <[email protected]>
@Siddhant-K-code Siddhant-K-code force-pushed the docs/readme-reframe-memory-reliability branch from 05c187c to d6595ca Compare May 9, 2026 07:22
@Siddhant-K-code Siddhant-K-code merged commit 0cae47f into main May 9, 2026
@Siddhant-K-code Siddhant-K-code deleted the docs/readme-reframe-memory-reliability branch May 9, 2026 07:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add a one-sentence differentiator to README and docs Reframe top-level messaging around memory reliability, not token reduction

1 participant