Canonical page: https://instantkv.com/docs/roadmap/

Repository source: https://github.com/maskjelly/instantKV/blob/main/docs/roadmap.md

# Local memory roadmap

The source MVP is implemented and unreleased.
The next milestone is a usable release with proven local-agent task continuation.
The [cleanup and release plan](https://instantkv.com/docs/project-plan/index.md) defines the work order and acceptance gates.

## Current source

* Structured `remember`, `recall`, `search`, `browse` and `forget`.
* Topic/tag/time indexes and bounded BM25 search with English stemming.
* Atomic record/index changes, revision conditions, quotas and expiry.
* Atomic checkpoint/latest-pointer commits and bounded restore.
* Embedded Rust core, authenticated HTTP, CLI and scoped MCP tools.
* Local profile, shared/private namespace setup, backup and restart tests.
* Optional source-only Python controller for reviewed proposals, corrections,
  conflicts, provenance, live profiles and content-free forgetting.

[Memory contract](https://instantkv.com/docs/memory-mvp/index.md) · [Checkpoint contract](https://instantkv.com/docs/agent-memory/index.md) ·
[Verification history](https://instantkv.com/docs/checkpoints/index.md)

## Next milestones

| Order | Work                               | Acceptance                                                                                             |
| ----- | ---------------------------------- | ------------------------------------------------------------------------------------------------------ |
| 1     | Clear onboarding and harness setup | One working source path; Codex, Claude Code and OpenCode setup examples; generated site and links pass |
| 2     | Real local-agent continuation      | Actual model saves, resets, restores and continues; complete traces and failure cases                  |
| 3     | Storage and upgrade hardening      | Disk-full/commit faults, single-writer diagnostics, binary compatibility and restore drills            |
| 4     | Memory MVP release                 | Matching tested binaries, checksums, fresh-install and upgrade tests on named platforms                |
| 5     | Retrieval improvements             | Held-out task gains after the frozen campaign, with measured resource costs                            |

For each supported harness, the release check must start from a clean config,
connect MCP, save one fact, stop, restart and recall that fact. Run the shared
server case with two concurrent adapters. Keep commands and expected results
in [Connect an agent](https://instantkv.com/docs/agents/index.md) and failure steps in [Operating one node](https://instantkv.com/docs/operations/index.md).

Retired-session cleanup, migration tools and observability need separate implementation work.
Native phone support and physical ARM-board measurements remain pending.
[Performance and device targets](https://instantkv.com/docs/performance/index.md).
Use the [private measurement guide](https://instantkv.com/docs/install-metrics/index.md) to track release
downloads and recent GitHub traffic. Actual source installations and active
local users remain unknown without an explicit opt-in signal.

## Evaluation status

The committed 4 October reports contain full LongMemEval-S and LoCoMo retrieval.
Full native LongMemEval-S QA scored 85.20% (426/500) using GPT-6 Luna as reader and judge.
This is a model variant, not official leaderboard parity. Competitor QA remains incomplete.
LongMemEval-V2, AMA-Bench, BEAM and 100K–10M+ record tests remain incomplete in the published evidence.

Keep the engine frozen during the finite campaign. Preserve failed and interrupted runs.
Real local-agent tests and storage smoke experiments do not substitute for full suites.
[Full results](https://instantkv.com/docs/full-retrieval/index.md) · [Evaluation policy](https://instantkv.com/docs/evaluation-policy/index.md).

## Memory product tasks

The controller follows [this implementation contract](https://github.com/maskjelly/instantKV/blob/main/docs/memory-controller-design.md).
It adds an optional local integration while keeping the Rust engine frozen.
M1-M4 are implemented in source. [Validation](https://github.com/maskjelly/instantKV/blob/main/docs/validation/2026-10-09-memory-controller.md)
records the combined real-node workflow and limits. [Use the controller](https://instantkv.com/docs/memory-controller/index.md).
The [OpenCode integration](https://instantkv.com/docs/opencode-controller/index.md) also passed a
[six-session model trial](https://github.com/maskjelly/instantKV/blob/main/docs/validation/2026-10-09-opencode-live.md).

| ID | Task                                                             | Completion check                                                                                                                                                     | Dependency                  |
| -- | ---------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------- |
| M1 | Completed: deterministic lifecycle and HTTP adapter              | Five focused lifecycle/HTTP scenarios and combined real-node restart workflow pass                                                                                   | Current API                 |
| M2 | Completed in source: optional extraction and interactive agent   | Six fake-model/transport/harness scenarios pass; installed-model quality remains M5                                                                                  | M1 interface                |
| M3 | Completed: CLI and operator guide                                | Saved-preview retry, inspection, correction, profile/context, permissions and forgetting pass through the real CLI                                                   | M1 interface, M2 extraction |
| M4 | Completed: integration and product review                        | Combined workflow, repository checks and site checks pass; changes committed                                                                                         | M1-M3                       |
| M5 | Completed: connected-model product trial                         | Six fresh OpenCode sessions save, recall, correct and forget one synthetic preference; traces, presentation friction and cost recorded                               | M4 and a connected provider |
| M6 | Partly complete: normal agent integration; long-term use pending | OpenCode lifecycle adapter installed and connected; safe archival/compaction, explicit restoration after forget and sustained use beyond per-slot limits remain open | M5 feedback                 |
| M7 | Broader memory quality                                           | Evaluate temporal facts, ambiguous entities and paraphrases on separate development cases before proposing semantic retrieval or graph reasoning                     | M5-M6                       |

M1-M5 cover implementation and one small product trial. M6-M7 remain broader
product gates. Model calls stay in the optional agent runtime; storage and lifecycle
validation remain model-free.

## Later proposals

Portable export/import comes before multi-device synchronization.
Phone bindings need lifecycle, sandbox, backup and energy tests on named devices.
Optional embeddings must earn their model, index and runtime costs.
[Distributed consolidation](https://instantkv.com/docs/distributed-memory/index.md) and managed hosting remain proposals without a delivery date.