diff --git a/packages/orchestrator/README.md b/packages/orchestrator/README.md
index ee05c9eb..aabd7243 100644
--- a/packages/orchestrator/README.md
+++ b/packages/orchestrator/README.md
@@ -1,4 +1,6 @@
-# orchestrator
+# @earendil-works/pi-orchestrator
+
+Experimental. This package is under active development and may change or be removed without notice. Its CLI, APIs, and behavior are not yet stable.
 
 Orchestrator package for pi.
 
diff --git a/packages/orchestrator/package.json b/packages/orchestrator/package.json
index 555169bc..617414dc 100644
--- a/packages/orchestrator/package.json
+++ b/packages/orchestrator/package.json
@@ -1,7 +1,7 @@
 {
 	"name": "@earendil-works/pi-orchestrator",
 	"version": "0.79.6",
-	"description": "orchestrator package for pi",
+	"description": "experimental orchestrator package for pi",
 	"type": "module",
 	"bin": {
 		"orchestrator": "dist/cli.js"