matterbridge 3.7.4-dev-20260415-a9eeb6f → 3.7.4-dev-20260416-fabcd3f

package/CHANGELOG.md

@@ -57,14 +57,18 @@ These classes will run as threads in the next releases:
 
 ### Dev news
 
-- [matter]: Add matterbridge/matter/model export to allow to create custom cluster with the newer matter.js decorator-based system.
+- [matter]: Add matterbridge/matter/model export to allow to create custom cluster with the matter.js decorator-based system.
 
 ### Added
 
-- [agent]: Add agent custom instructions for copilot and claude.
+- [agent]: Add `.github\copilot-instructions.md` for Copilot.
+- [agent]: Add `.claude\CLAUDE.md` for Claude.
+- [agent]: Add agent custom instructions (testing) for Copilot and Claude.
+- [agent]: Add agent custom instructions (matterbridge) for Copilot and Claude.
 - [agent]: Add agent prompt files.
 - [matter]: Add [Matter 1.5.1 changes from 1.4.2](Matter-1.5.1.md).
 - [storage]: Create storage directories on start.
+- [config]: The dialog to blacklist an entity now shows only the entities not already blacklisted. Thanks [Tamer Salah](https://github.com/tammeryousef1006).
 
 ### Changed
 
@@ -72,6 +76,7 @@ These classes will run as threads in the next releases:
 - [package]: Bump `matter.js` to v.0.16.11.
 - [package]: Bump `node-ansi-logger` to v.3.2.1.
 - [package]: Bump `node-persist-manager` to v.2.0.2.
+- [frontend]: Update dependencies.
 - [frontend]: Bump `frontend` version to v.3.4.12.
 
 <a href="https://www.buymeacoffee.com/luligugithub"><img src="https://matterbridge.io/assets/bmc-button.svg" alt="Buy me a coffee" width="80"></a>

package/README-DEV.md

@@ -105,6 +105,22 @@ Dev containers have networking limitations depending on the host OS and Docker s
 
 - ✅ Matterbridge frontend works normally
 
+## Copilot instructions
+
+| File                                                             | Notes                                                            |
+| ---------------------------------------------------------------- | ---------------------------------------------------------------- |
+| `.github/copilot-instructions.md`                                | Main project instructions — always loaded                        |
+| `.github/instructions/matterbridge/matterbridge.instructions.md` | Matterbridge endpoint guide — dedicated Copilot instruction file |
+| `.github/instructions/testing/unit-tests.instructions.md`        | Testing standards — scoped to `packages/**/*.test.ts`            |
+
+## Claude instructions
+
+| File                                                      | Notes                                                 |
+| --------------------------------------------------------- | ----------------------------------------------------- |
+| `.claude/CLAUDE.md`                                       | Main project instructions — always loaded             |
+| `.claude/rules/matterbridge/matterbridge.instructions.md` | Matterbridge endpoint guide — loaded for all contexts |
+| `.claude/rules/testing/unit-tests.instructions.md`        | Testing standards — scoped to `packages/**/*.test.ts` |
+
 ## Guidelines on imports/exports
 
 Matterbridge exports from:

package/README-DOCKER.md

@@ -89,8 +89,12 @@ After adding your user to the `docker` group, log out and log back in so your cu
 
 The container must have full access to the host network (needed for mDNS and the Matter protocol).
 
+Linux (bash):
+
 ```bash
 sudo docker pull luligu/matterbridge:latest
+sudo docker stop matterbridge 2>/dev/null
+sudo docker rm matterbridge 2>/dev/null
 sudo docker run --name matterbridge \
   -v ~/Matterbridge:/root/Matterbridge \
   -v ~/.matterbridge:/root/.matterbridge \
@@ -104,6 +108,8 @@ You may need to adapt the paths to your setup.
 
 ```bash
 sudo docker pull luligu/matterbridge:latest
+sudo docker stop matterbridge 2>/dev/null
+sudo docker rm matterbridge 2>/dev/null
 sudo docker run --name matterbridge \
   -v ~/Matterbridge:/root/Matterbridge \
   -v ~/.matterbridge:/root/.matterbridge \
@@ -182,6 +188,14 @@ docker compose pull matterbridge
 docker compose up -d --no-deps --force-recreate matterbridge
 ```
 
+This pulls all images and restarts all containers:
+
+```bash
+docker compose pull
+docker compose down
+docker compose up -d
+```
+
 ### Inspect the container
 
 ```bash
@@ -261,3 +275,49 @@ sudo systemctl restart docker
 ```
 
 **Note**: This configuration applies to new containers. Existing containers must be recreated to use the new logging settings.
+
+## Run with Docker Desktop and mDNS Reflector on Windows
+
+Windows (PowerShell) with Docker Desktop (use the [**Matterbridge mDNS Reflector**](https://matterbridge.io/reflector/Reflector.html) if you want to pair with a controller on the local network):
+
+```powershell
+docker pull luligu/matterbridge:latest
+docker stop matterbridge 2>$null
+docker rm matterbridge 2>$null
+docker run --name matterbridge `
+  -p 8283:8283 -p 5540-5559:5540-5559/udp `
+  -v ${env:USERPROFILE}/Matterbridge:/root/Matterbridge `
+  -v ${env:USERPROFILE}/.matterbridge:/root/.matterbridge `
+  -v ${env:USERPROFILE}/.mattercert:/root/.mattercert `
+  --restart always -d luligu/matterbridge:latest matterbridge --docker --frontend 8283 --port 5540
+```
+
+Windows (Command Prompt) with Docker Desktop (use the [**Matterbridge mDNS Reflector**](https://matterbridge.io/reflector/Reflector.html) if you want to pair with a controller on the local network):
+
+```cmd
+docker pull luligu/matterbridge:latest
+docker stop matterbridge 2>nul
+docker rm matterbridge 2>nul
+docker run --name matterbridge ^
+  -p 8283:8283 -p 5540-5559:5540-5559/udp ^
+  -v %USERPROFILE%/Matterbridge:/root/Matterbridge ^
+  -v %USERPROFILE%/.matterbridge:/root/.matterbridge ^
+  -v %USERPROFILE%/.mattercert:/root/.mattercert ^
+  --restart always -d luligu/matterbridge:latest matterbridge --docker --frontend 8283 --port 5540
+```
+
+## Run with Docker Desktop and mDNS Reflector on macOS
+
+macOS (bash/zsh) with Docker Desktop (use the [**Matterbridge mDNS Reflector**](https://matterbridge.io/reflector/Reflector.html) if you want to pair with a controller on the local network):
+
+```zsh
+sudo docker pull luligu/matterbridge:latest
+sudo docker stop matterbridge 2>/dev/null
+sudo docker rm matterbridge 2>/dev/null
+sudo docker run --name matterbridge \
+  -p 8283:8283 -p 5540-5559:5540-5559/udp \
+  -v ~/Matterbridge:/root/Matterbridge \
+  -v ~/.matterbridge:/root/.matterbridge \
+  -v ~/.mattercert:/root/.mattercert \
+  --restart always -d luligu/matterbridge:latest matterbridge --docker --frontend 8283 --port 5540
+```