Bamboo add-on for Home Assistant

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

README.md

@@ -1,2 +1,19 @@
-# bamboo-ha
+# Bamboo for Home Assistant
 
+A Home Assistant add-on (also called an app) that runs [Bamboo](https://git.veillax.com/Veillax/bamboo), the site agent of the Hammerhead stack. It connects your home network to a Blacktip edge over WireGuard, so Home Assistant and your other devices can be reached from the internet without opening ports on your router.
+
+## Install
+
+1. In Home Assistant, go to **Settings**, then **Add-ons**, then **Add-on store**.
+2. Open the menu at the top right, choose **Repositories**, and add `https://git.veillax.com/Veillax/bamboo-ha`.
+3. Install **Bamboo**, fill in its configuration, and start it. See the add-on's Documentation tab for the details, including the `http:` setting Home Assistant needs.
+
+It builds on your Home Assistant machine the first time you install it. It supports amd64, aarch64 and armv7.
+
+## For maintainers
+
+The add-on version is the Bamboo release it installs: version `0.1.5` downloads Bamboo `v0.1.5` and checks it against that release's `SHA256SUMS`. To follow a new Bamboo release, change `version` in `bamboo/config.yaml` (and the default of `BUILD_VERSION` in `bamboo/Dockerfile`), and add a line to `bamboo/CHANGELOG.md`.
+
+## License
+
+AGPL-3.0, the same as Bamboo. See `LICENSE`.