halilneed · Sep 18, 2026 · Sep 18, 2026 · Sep 18, 2026 · Sep 18, 2026 · Sep 18, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,17 +1,34 @@
 # Changelog
 
-## 0.1.0-alpha.2 — Unreleased
-
-- Repositioned AgentMemora as a **Memory & Context Control Plane for AI coding agents**.
-- Added premium terminal-style Memory Intelligence dashboard.
-- Added session-only memory candidate and context-loss risk detection.
-- Added conservative key/value conflict detection across durable memory sources.
-- Added preservation coverage and stale-memory posture signals.
-- Added deterministic **Context Capsule** export from Claude Code sessions.
-- Added copyable Claude Code Resume and Fork commands per session.
-- Added guarded `promote` command for reviewed memory curation with explicit `--yes` and automatic backups.
-- Kept vendor JSONL transcripts read-only.
-- Moved tool/model/token statistics to supporting telemetry instead of the product center.
+All notable public changes to AgentMemora are documented here.
+
+## 0.2.0 — 2026-09-18
+
+### Project-first context browsing
+- Group Claude Code history by local project.
+- Show primary-session, subagent, prompt, and tool counts per project.
+- Browse primary sessions in compact cards instead of one full-width stream.
+- Show every indexed subagent transcript under its project rather than truncating the detailed list.
+- Search across projects, sessions, subagents, models, tools, and paths.
+
+### First-run usability
+- Add a three-step Start Here path: choose a project -> inspect what survived -> preserve useful context.
+- Make Projects the primary navigation path.
+- Keep Resume, Fork, readable transcript, and Context Capsule actions available at session level.
+
+### Safety
+- Vendor JSONL remains read-only.
+- Dashboard remains localhost-only by default.
+- Durable-memory writes still require an explicit target, confirmation, and backup.
+
+## 0.1.0
+
+- Initial Memory Intelligence Control Plane.
+- Claude Code session inventory and subagent distinction.
+- Durable memory/instruction discovery.
+- Context-loss candidates, conservative conflicts, stale-memory signals, and preservation coverage.
+- Resume/Fork command generation and deterministic Context Capsule export.
+- Guarded CLI promotion with backup.
 
 ## 0.1.0-alpha.1
 

diff --git a/README.md b/README.md
@@ -6,7 +6,7 @@
 
 [![npm version](https://img.shields.io/npm/v/agentmemora.svg)](https://www.npmjs.com/package/agentmemora) [![CI](https://github.com/hailneed/agentmemora/actions/workflows/ci.yml/badge.svg)](https://github.com/hailneed/agentmemora/actions/workflows/ci.yml) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 
-<p align="center"><img src="docs/AgentMemora-preview.svg" alt="AgentMemora memory intelligence console" width="100%" /></p>
+<p align="center"><img src="https://raw.githubusercontent.com/hailneed/agentmemora/main/docs/AgentMemora-preview.svg" alt="AgentMemora memory intelligence console" width="100%" /></p>
 
 AgentMemora is a **local-first memory intelligence layer** for coding agents. It reads the state your tools already create — session transcripts, auto-memory, project instructions, rules, and runtime memory events — and turns it into a control plane for **inspection, curation, preservation, and transfer**.
 
@@ -43,6 +43,22 @@ Want to inspect the environment first?
 npx -y agentmemora@latest doctor
 ```
 
+## Start here
+
+The first useful path is intentionally simple:
+
+```text
+Choose a project
+      ↓
+Inspect its primary sessions + every indexed subagent trace
+      ↓
+Compare session-only context with durable memory/instructions
+      ↓
+Resume / Fork / export a Context Capsule before useful context is lost
+```
+
+The dashboard groups local history by project first, so you do not have to hunt through one global session stream.
+
 ## What makes AgentMemora different
 
 AgentMemora focuses on the questions that appear after an agent has worked with you for a while:
@@ -229,7 +245,7 @@ pytest -q
 
 ## Roadmap
 
-Next: reviewed candidate → memory promotion from the UI, semantic conflict analysis, selective Context Surgery, cross-agent capsule adapters, memory diff/rollback, secret/PII redaction hooks, and memory regression checks.
+v0.2 focuses on making local context understandable: project-first navigation, complete indexed subagent visibility, compact session browsing, and a clear first-run workflow. Next: reviewed candidate → memory promotion from the UI, semantic conflict analysis, selective Context Surgery, cross-agent capsule adapters, memory diff/rollback, secret/PII redaction hooks, and memory regression checks.
 
 See [ROADMAP.md](docs/ROADMAP.md).
 

diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md
@@ -16,7 +16,17 @@
 - [x] Backup before memory mutation
 - [x] Localhost-only / no-telemetry defaults
 
-## v0.2 — Curate
+## v0.2 — Project-first Context Explorer
+- [x] Project-level session inventory
+- [x] Project-level subagent inventory
+- [x] Complete indexed subagent listing in detailed explorer
+- [x] Compact session cards instead of full-width history rows
+- [x] Project/session/subagent search
+- [x] Clear first-run path: project -> durable context -> preserve/transfer
+- [x] Resume / Fork / Context Capsule actions remain available per session
+- [x] Local/read-only safety boundary preserved
+
+## v0.3 — Curate
 - [ ] Review candidate -> promote to memory from dashboard
 - [ ] Memory diff / rollback UI
 - [ ] Memory provenance timeline
@@ -25,15 +35,15 @@
 - [ ] Repeated correction clustering
 - [ ] PII / secret redaction before capsule export
 
-## v0.3 — Context Surgery
+## v0.4 — Context Surgery
 - [ ] Select exact turns/decisions from a session
 - [ ] Generate a capsule from only the selected context
 - [ ] Classify decisions, constraints, preferences, failures, open tasks, important files
 - [ ] Cross-agent capsule adapters for Claude Code, Codex, Cursor and Copilot surfaces
 - [ ] Import/export capsule manifest with provenance
 - [ ] Cross-machine project handoff workflow
 
-## v0.4 — Memory Reliability
+## v0.5 — Memory Reliability
 - [ ] Temporal consistency checks
 - [ ] Memory regression tests
 - [ ] Memory poisoning / suspicious-instruction signals

diff --git a/package.json b/package.json
@@ -40,7 +40,8 @@
     "bin/",
     "src-node/",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "CHANGELOG.md"
   ],
   "publishConfig": {
     "access": "public"