diff --git a/.changeset/onboarding-improvements.md b/.changeset/onboarding-improvements.md
new file mode 100644
index 000000000..f0a1a4ddb
--- /dev/null
+++ b/.changeset/onboarding-improvements.md
@@ -0,0 +1,12 @@
+---
+"@composio/ao-core": minor
+"@composio/ao-cli": minor
+"@composio/ao": minor
+"@composio/ao-web": minor
+"@composio/ao-plugin-agent-claude-code": patch
+"@composio/ao-plugin-agent-aider": patch
+"@composio/ao-plugin-agent-codex": patch
+"@composio/ao-plugin-agent-opencode": patch
+---
+
+Zero-friction onboarding: `ao start` auto-detects project, generates config, and launches dashboard — no prompts, no manual setup. Renamed npm package to `@composio/ao`. Made `@composio/ao-web` publishable with production entry point. Cross-platform agent detection. Auto-port-finding. Permission auto-retry in shell scripts.