diff --git a/CLAUDE.md b/CLAUDE.md
index 9e46238..186de9c 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -2,6 +2,15 @@
 
 This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
 
+## Status: proof of concept
+
+`v0.6.0` is a **POC snapshot** — the widest the command surface ever got. From here the
+direction is *subtractive*: commands are being removed to cut complexity, and a few will
+be reimplemented later in a simpler shape. So when you read the sections below, treat the
+command surface as **the state at v0.6.0, not a commitment** — check `registry.ts` (and
+`git log`) before assuming a command described here still exists, and prefer deleting a
+subsystem's docs along with its code over leaving them describing something that's gone.
+
 ## What this is
 
 `tabbrew-cli` is a Bun + TypeScript CLI (`tabbrew` binary) that authenticates to a
diff --git a/README.md b/README.md
index ee19b2b..ad44076 100644
--- a/README.md
+++ b/README.md
@@ -5,6 +5,11 @@
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
 [![Bun](https://img.shields.io/badge/Bun-%E2%89%A5%201.1-000?logo=bun&logoColor=white)](https://bun.sh)
 
+> **Status: proof of concept.** `v0.6.0` is the high-water mark of the exploration —
+> everything the CLI can currently do, kept together in one release. The next versions
+> deliberately **remove** commands to cut complexity, and some of them will come back
+> later in a simpler shape. Pin `v0.6.0` if you depend on a command that disappears.
+
 The command-line companion to **TabBrew** — it brings your TabBrew account to the
 terminal and to the AI coding agents working there.
 
diff --git a/package.json b/package.json
index 84fd014..d58f856 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "tabbrew-cli",
-  "version": "0.5.5",
+  "version": "0.6.0",
   "description": "Push HTML docs into TabBrew from your terminal — a Bun + TypeScript CLI.",
   "type": "module",
   "license": "MIT",