diff --git a/.changeset/curvy-cheetahs-buy.md b/.changeset/curvy-cheetahs-buy.md
index 89c9e9f..6d24bbf 100644
--- a/.changeset/curvy-cheetahs-buy.md
+++ b/.changeset/curvy-cheetahs-buy.md
@@ -2,4 +2,17 @@
 'aibitat': patch
 ---
 
-added plugin support
+Added plugins support to the AIbitat instance. This allows you to extend the
+AIbitat instance with additional functionality.
+
+```ts
+import { AIbitat } from 'aibitat';
+
+const aibitat = new AIbitat(...)
+    .use({
+        name: 'my-plugin',
+        setup: (aibitat) => {
+            // do something with the AIbitat instance
+        },
+    });
+```
diff --git a/.changeset/eighty-buses-return.md b/.changeset/eighty-buses-return.md
index 216bb4c..b6f0e35 100644
--- a/.changeset/eighty-buses-return.md
+++ b/.changeset/eighty-buses-return.md
@@ -2,4 +2,16 @@
 'aibitat': patch
 ---
 
-Added `web-browsing` plugin
+Added `experimental_webBrowsing` plugin to allow you to browse the web from your
+AIbitat instance.
+
+```ts
+import { AIbitat } from 'aibitat';
+import { experimental_webBrowsing } from 'aibitat/plugins';
+
+const aibitat = new AIbitat(...)
+    .use(experimental_webBrowsing());
+```
+
+NOTE: This plugin is still in development and is not yet ready for use in
+production.
diff --git a/.changeset/friendly-needles-smile.md b/.changeset/friendly-needles-smile.md
index 2d67c3d..cf8b060 100644
--- a/.changeset/friendly-needles-smile.md
+++ b/.changeset/friendly-needles-smile.md
@@ -2,4 +2,4 @@
 'aibitat': patch
 ---
 
-add dist files in the exported module
+fix a bug where compiled files were not being included in the npm package
diff --git a/.changeset/lazy-windows-arrive.md b/.changeset/lazy-windows-arrive.md
index 613808c..ddf3d42 100644
--- a/.changeset/lazy-windows-arrive.md
+++ b/.changeset/lazy-windows-arrive.md
@@ -2,4 +2,5 @@
 'aibitat': patch
 ---
 
-fix a where it was selecting the wrong the next participant in the group
+fix a bug where it was selecting the wrong the next participant in the group
+chat
diff --git a/.changeset/soft-brooms-develop.md b/.changeset/soft-brooms-develop.md
index daba08d..ccd99e1 100644
--- a/.changeset/soft-brooms-develop.md
+++ b/.changeset/soft-brooms-develop.md
@@ -2,4 +2,13 @@
 'aibitat': patch
 ---
 
-fix module exports
+Added `aibitat/plugins` as a plugin directory. This allows you enable plugins to
+your AIbitat instance.
+
+```ts
+import { AIbitat } from 'aibitat';
+import { cli } from 'aibitat/plugins';
+
+const aibitat = new AIbitat(...)
+    .use(cli());
+```
diff --git a/.changeset/thick-pumas-thank.md b/.changeset/thick-pumas-thank.md
index 288fff5..d2bab19 100644
--- a/.changeset/thick-pumas-thank.md
+++ b/.changeset/thick-pumas-thank.md
@@ -2,4 +2,4 @@
 'aibitat': patch
 ---
 
-added `onStart` event
+added `onStart` event that is called when the chat starts.
diff --git a/.changeset/wise-walls-pay.md b/.changeset/wise-walls-pay.md
index 38d7c69..09ae3a1 100644
--- a/.changeset/wise-walls-pay.md
+++ b/.changeset/wise-walls-pay.md
@@ -2,4 +2,4 @@
 'aibitat': patch
 ---
 
-`fileHistory` plugin
+Added `fileHistory` plugin to the list of available plugins.
diff --git a/README.md b/README.md
index 1c06f3b..7c93112 100644
--- a/README.md
+++ b/README.md
@@ -193,6 +193,15 @@ export function myPlugin(): AIbitatPlugin {
 }
 ```
 
+**List of available plugins:**
+
+- `cli`: Adds a CLI interaction to the chat.
+- `fileHistory`: Saves the chat history to a JSON file. Defaults to `history`
+  folder
+- `experimental_webBrowsing`: Adds a `web-browsing` function to the chat that
+  enable agents to search and navigate on the internet. NOTE: this plugin is
+  experimental and may not work as expected.
+
 ### Listening to events
 
 You can listen to events using the `on` method: