From 232535c8eabc49d687729690552c015e1ee024b9 Mon Sep 17 00:00:00 2001
From: SEUNGWOO LEE <69357689+lifrary@users.noreply.github.com>
Date: Sun, 11 Oct 2026 15:42:53 +0900
Subject: [PATCH] release: document v0.6.0 features and upgrade instructions

---
 CHANGELOG.md | 15 +++++++++++----
 README.md    | 30 ++++++++++++++++++++++++++----
 2 files changed, 37 insertions(+), 8 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 30e610b..a0d2c91 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,10 +4,10 @@ All notable changes to this project are documented here. The format follows [Kee
 
 ## [Unreleased]
 
-### 0.6.0 — recovery, search coverage and usage
+## [v0.6.0] — 2026-10-11
 
-This release combines the 0.5 and 0.6 roadmap milestones. It is not yet
-published to npm; there is no separate 0.5.0 publication.
+This release combines the 0.5 and 0.6 roadmap milestones: recovery,
+search coverage and usage. There is no separate 0.5.0 release.
 
 ### Added
 
@@ -37,7 +37,14 @@ published to npm; there is no separate 0.5.0 publication.
   prefixes, preserving usable file selectors while still redacting cards.
 - Git context is explicitly current, with redaction before display shortening.
 - The roadmap now prioritizes finding and resuming reliably, then complete
-  usage accounting; release metadata is prepared for 0.6.0.
+  usage accounting.
+
+### Fixed
+
+- Canonical native Codex paths retain child usage and cache invalidation
+  when the configured home uses filesystem ancestor aliases, including
+  macOS `/var` and `/private/var`. Native symlink and regular-file checks
+  remain enforced.
 
 ### Limits
 
diff --git a/README.md b/README.md
index 07ed25b..f79c8ad 100644
--- a/README.md
+++ b/README.md
@@ -40,10 +40,12 @@ If agent-tree saves you a scroll, a ⭐ on GitHub helps others find it.
 ## Install
 
 ```bash
-npm install -g @seungwoolee/agent-tree
+npm install -g @seungwoolee/agent-tree@latest
+agent-tree --version
 ```
 
 This installs the `agent-tree` command and its short alias `atree`. It needs Node.js 22.13 or later. To let Claude browse sessions for you, add [the Claude Code plugin](#use-it-inside-claude-code) as well.
+Run the same install command to upgrade an existing installation.
 
 New work lands on `main` first and reaches npm with the next release, so npm can trail `main`; `npm view @seungwoolee/agent-tree version` shows what npm has.
 
@@ -84,11 +86,31 @@ agent-tree --list --usage              # tokens per step and how full the contex
 agent-tree --open 7                    # start a new session from step 7, no paste
 agent-tree --picks                     # every starred step, across sessions
 agent-tree --sessions --limit 10       # recent sessions, all projects
+agent-tree --sessions --usage --limit 5 # opt-in main + child token totals
 agent-tree 3f9c2a71 --list             # a specific session, by ID prefix
 ```
 
 If `ANTHROPIC_API_KEY` is set, agent-tree also asks Claude for short step labels, which bills your Anthropic account. Add `--no-llm` to skip that. `agent-tree --help` lists every option.
 
+### New in 0.6.0
+
+Version 0.6.0 combines the recovery/search and usage milestones:
+
+- **Recover context, not just one prompt.** Continue carries bounded prior
+  instructions, replies and recorded compaction summaries. Fork stops before
+  the selected question's subsequent work. Cutoffs and missing context are
+  explicit; neither mode restores historical files.
+- **Find archived and delegated work.** Search includes Codex archives and
+  both agents' child transcripts, with file selectors and proven parent steps.
+- **Account for Codex children.** Descendant tokens stay separate from main
+  usage; evidenced inherited calls are deduplicated and unknown attribution
+  is labeled rather than guessed.
+- **Compare recent sessions on demand.** `--sessions --usage` and MCP
+  `agent_tree_sessions` with `usage: true` add token totals. The default
+  catalog stays metadata-only; absent usage is not reported as zero.
+
+See the [0.6.0 changelog](./CHANGELOG.md#v060--2026-10-11) for details and limits.
+
 ## Features
 
 <table>
@@ -647,9 +669,9 @@ Before every paid request, agent-tree counts the prepared prompt with `messages.
   duplicate inherited calls, distinguish unassigned usage, and offer opt-in
   session-list totals without slowing the default catalog.
 
-The 0.5 and 0.6 milestones were implemented together for 0.6.0. Repository
-implementation and npm publication are separate; the latest published release
-remains 0.4.0 until the release checklist is completed.
+The 0.5 and 0.6 milestones ship together in **0.6.0**; there is no separate
+0.5.0 release. Check [GitHub releases](https://github.com/lifrary/agent-tree/releases)
+and `npm view @seungwoolee/agent-tree version` for distribution availability.
 
 Have an idea or hit a bug? [Open an issue](https://github.com/lifrary/agent-tree/issues).