Release Notes - v0.5.7.dev0

Release Date: 2026-04-09
Changes: v0.5.8rc1 → dev

Pull Requests: #2126

Summary

This release continues the v2 memory-first API work and improves local and cloud developer workflows. It introduces major session-memory features (session-only remembers/search, automatic session search on prompts), a new public SaaS frontend subset, cognee.serve() to connect the SDK to Cognee Cloud (and run a local instance), and various reliability, performance, and pipeline improvements.

Highlights

• New session-first memory behaviors: session-only remembers, session cache full-text storage, and automatic session search on every prompt.
• cognee.serve() to connect your SDK to Cognee Cloud or run local instances; cognee.visualize now exposed in the v2 API.
• Public subset of a new SaaS frontend included (updated UI + assets) for easier local cloud-like testing.
• Performance: lazy imports -> ~7.6x faster startup; pipeline improvements including parallel execution and concurrency limiting.
• Breaking change: cognee.status() and related freshness/status hooks were removed.

Breaking Changes

• Removed cognee.status(): code or tooling that relied on cognee.status() or its freshness checks must be updated — references to this API and related checks have been removed.
• Frontend changes: the old cognee-frontend demo/example assets were replaced with a new SaaS frontend subset. If you have local customizations that depended on the previous frontend files (assets, demo data, or routes), you'll need to update them to match the new layout and asset set.
• Default local user email changed to local-ui@cognee.local. If you relied on the previous default email in scripts or tests, update them accordingly.

New Features

• Session memory enhancements: remember() now supports separate session-only and permanent memory paths, session IDs are unified, and session-only recall is supported.
• Automatic session search on every prompt via the UserPromptSubmit hook so relevant session memory is surfaced without manual steps.
• Session cache improvements: store full text, support multiple entries per session, and carry session_ids in RememberResult for easier traceability.
• cognee.serve(): connect the SDK to Cognee Cloud or run against a local instance (local instance support added).
• cognee.visualize exposed in the v2 API as cognee.visualize for programmatic dataset visualization.
• New self-improvement pipeline and graph-to-session sync; RememberResult can be returned as a promise and is displayed in the CLI and Claude plugin.
• New simplified pipeline patterns and declarative TaskSpec/BoundTask/run_pipeline features for deferred-call pipelines.

Improvements

• Frontend: replaced old cognee-frontend with a new SaaS frontend public subset — updated pages, components, assets, and onboarding flows for a cloud-first developer experience.
• Filesystem cache TTL support added and max_context_chars wired up so cached entries can expire and context size is enforced.
• Example apps revised: clearer permanent vs session memory patterns, per-source status and freshness checks, and run_migrations() to make example runs repeatable.
• Pipeline engine: added concurrency limiting, incremental loading, parallel execution, and per-item context injection in parallel mode for better throughput and scalability.
• Default local user email changed to local-ui@cognee.local to simplify local sign-in flows.
• Startup performance improved by ~7.6x via lazy imports in cognee/init.py.
• Claude plugin and CLI improved with session/feedback args and updated scripts for session sync and search.

Bug Fixes

• Multiple CI/test stability fixes: increased timing thresholds in flaky tests, improved imports/patching in tests, and MagicMock serialization fixes.
• Lint and formatting fixes (ruff) and removal of stray trailing whitespace/newlines in multiple files.
• Fixed usage of create_db_and_tables for fresh databases in examples and enabled filesystem caching in examples to support session behavior.
• Fixed word-boundary session search, unified session_ids across features, and resolved various import-order issues.
• Removed leftover references to a removed freshness check to avoid runtime errors.

Technical Changes

• Removed dead code including the unused Pipe[T] subsystem and the old cognee.status implementation to simplify the codebase.
• Library upgrades: litellm bumped to 1.83.1 and graphiti-core to >=0.28.0.
• Refactoring and internal API changes across the v2 memory-oriented API (remember, recall, improve), pipeline infrastructure, and task execution patterns.
• Many internal test and CI harness changes (imports, mocks, and test context migration to PipelineContext) to improve reliability.

Generated by Cognee Release Notes Generator on 2026-04-09