From 9b359b6452287f981df659072b6aaa3787fa2463 Mon Sep 17 00:00:00 2001
From: Mohamed Boudra <boudra.moha@gmail.com>
Date: Wed, 19 Aug 2026 12:24:57 +0200
Subject: [PATCH] docs(plugins): document experimental plugin status

---
 public-docs/plugins/index.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/public-docs/plugins/index.md b/public-docs/plugins/index.md
index 56ff48061..d1d6d074b 100644
--- a/public-docs/plugins/index.md
+++ b/public-docs/plugins/index.md
@@ -8,6 +8,10 @@ category: Plugins
 
 # Plugin quickstart
 
+> **Experimental:** Plugins are intended for personal, local use and are not designed for
+> distribution yet. The plugin API is still evolving, so expect breaking changes and updates to
+> your plugins as Paseo evolves.
+
 Paseo plugins add native workspace panels, Command Center items, global surfaces, daemon behavior, and composer attachment sources. They run on every Paseo client connected to the host, including mobile.
 
 Plugins are trusted local code. Install only code you trust: backend code runs unsandboxed with access to the daemon machine, and client contributions run inside the Paseo app.