Remove temporary Claude build diagnostic

.github/stargazer_countries.csv

@@ -162,7 +162,6 @@ DARKNAGAN,France
 DDanii,
 DMurzNN,
 DUC750,
-DY-hub,
 DaFlowah,
 DaJonas94,
 Daafip,Netherlands
@@ -239,7 +238,6 @@ EtienneMD,
 Evel270,
 Everestlion,
 EvertJob,
-Exlatis,
 Extrunder,
 F0264,
 F4bsi,Germany
@@ -565,7 +563,6 @@ PhoenixTwoFive,Germany
 PhysShell,
 PierreNa,France
 PietroSpina,
-Pingmin,
 PiotrKrzyzek,United States
 PiratesGhost,
 Pixelzeus,
@@ -900,12 +897,10 @@ antorimba,
 antx-code,
 anyezhe,
 aorosora,
-araminimichael,
 arbal,United States
 ardemk,
 ared469,
 arethefreshest,
-arozoire,
 arpit-mehra,
 artemave,France
 artemdanielov,
@@ -1161,7 +1156,6 @@ danbruno,
 danctrl,Germany
 danez,United States
 danieldotnl,Netherlands
-danishru,
 dannybeeckman,
 dannybloomfield,United States
 danveitch76,
@@ -1750,7 +1744,6 @@ ljsquare,
 llabourdeth,
 llewy,
 llfjahn,
-llugo,
 lmalmoreno,Brazil
 lnrdmx,
 loc4t3llix,
@@ -2057,7 +2050,6 @@ pedrolicassali,
 pedromfa,
 pedrware,Portugal
 peeetek,
-peggleg,
 pejannl,
 pem884,United States
 pepelatc,
@@ -2281,7 +2273,6 @@ skalingclouds,United States
 skamaleo,
 skavieller,
 skipper00,
-skoducks,United States
 skylidefr,
 skynet-network,
 slimehands,
@@ -2541,7 +2532,6 @@ williamcorsel,Netherlands
 willigenburggihaux,
 willnewcombe,United Kingdom
 wimb0,
-wingerasc,
 witold-gren,Poland
 wonderfulhuber,
 wonkygecko,United States

.github/workflows/onpr_check-pr.yaml

@@ -35,7 +35,6 @@ jobs:
           git fetch origin "${{ github.event.before }}" || true
           changed_changelog_files=$(git diff --name-only "${{ github.event.before }}" "${{ github.sha }}" | grep -iE '^([^/]+/)?changelog\.(md|txt|ya?ml|json)$' || true)
           echo "$changed_changelog_files"
-          echo "changelogs_files=$changed_changelog_files" >> "$GITHUB_OUTPUT"
           changed_config_files=$(git diff --name-only "${{ github.event.before }}" "${{ github.sha }}" | grep -E '^[^/]+/config\.(json|ya?ml)$' || true)
           echo "$changed_config_files"
           all_changed_files=$(echo -e "$changed_config_files\n$changed_changelog_files" | sort -u)
@@ -209,7 +208,6 @@ jobs:
         uses: docker/build-push-action@v7
         with:
           context: ${{ matrix.addon }}
-          platforms: linux/arm64
           push: false
           load: true
           file: ${{ matrix.addon }}/Dockerfile

.github/workflows/onpush_builder.yaml

@@ -300,7 +300,7 @@ jobs:
 
       - name: Build ${{ matrix.addon }} add-on
         if: steps.info.outputs.build_arch == 'true' && steps.info.outputs.has_dockerfile == 'true'
-        uses: home-assistant/builder/actions/build-image@2026.06.0
+        uses: home-assistant/builder/actions/build-image@2026.03.2
         with:
           arch: ${{ matrix.arch }}
           cache-gha: "false"
@@ -433,3 +433,4 @@ jobs:
           done
 
           git push origin HEAD:master
+  

README.md

@@ -56,19 +56,19 @@ If you want to do add the repository manually, please follow the procedure highl
 
 ### Number of addons
 
-- In the repository : 136
-- Installed : 626324
+- In the repository : 135
+- Installed : 508490
 
 ### Top 3
 
-1. Arpspoof (86665x)
-2. Sponsorblockcast (82801x)
-3. Jellyfin (71957x)
+1. Arpspoof (59486x)
+2. Sponsorblockcast (55582x)
+3. Flaresolverr (44486x)
 
 ### Architectures used
 
-- amd64: 90%
-- aarch64: 10%
+- amd64: 88%
+- aarch64: 12%
 
 ### Stars evolution
 
@@ -77,7 +77,7 @@ If you want to do add the repository manually, please follow the procedure highl
 ## Add-ons provided by this repository
 
 %%ADDONS_LIST%%
-✓  [Arpspoof (86665x)](arpspoof/) : block internet connection for local network devices
+✓  [Arpspoof (59486x)](arpspoof/) : block internet connection for local network devices
 
   ![Version](https://img.shields.io/badge/dynamic/yaml?label=Version&query=%24.version&url=https%3A%2F%2Fraw.githubusercontent.com%2Falexbelgium%2Fhassio-addons%2Fmaster%2Farpspoof%2Fconfig.yaml)
 ![Update](https://img.shields.io/badge/dynamic/json?label=Updated&query=%24.last_update&url=https%3A%2F%2Fraw.githubusercontent.com%2Falexbelgium%2Fhassio-addons%2Fmaster%2Farpspoof%2Fupdater.json)
@@ -143,17 +143,6 @@ If you want to do add the repository manually, please follow the procedure highl
 ![amd64][amd64-badge]
 ![ingress][ingress-badge]
 
-✓ ![image](https://api.iconify.design/mdi/bird.svg) [BirdNET-Pi (zach7036)](birdnet-pi-zach/) : Realtime acoustic bird classification system
-
-  ![Version](https://img.shields.io/badge/dynamic/yaml?label=Version&query=%24.version&url=https%3A%2F%2Fraw.githubusercontent.com%2Falexbelgium%2Fhassio-addons%2Fmaster%2Fbirdnet-pi-zach%2Fconfig.yaml)
-![Update](https://img.shields.io/badge/dynamic/json?label=Updated&query=%24.last_update&url=https%3A%2F%2Fraw.githubusercontent.com%2Falexbelgium%2Fhassio-addons%2Fmaster%2Fbirdnet-pi-zach%2Fupdater.json)
-![aarch64][aarch64-badge]
-![amd64][amd64-badge]
-![ingress][ingress-badge]
-![mqtt][mqtt-badge]
-![smb][smb-badge]
-![localdisks][localdisks-badge]
-
 ✓ ![image](https://api.iconify.design/mdi/bird.svg) [BirdNET-PiPy](birdnet-pipy/) : BirdNET-PiPy bird detection with a modern web dashboard
 
   ![Version](https://img.shields.io/badge/dynamic/yaml?label=Version&query=%24.version&url=https%3A%2F%2Fraw.githubusercontent.com%2Falexbelgium%2Fhassio-addons%2Fmaster%2Fbirdnet-pipy%2Fconfig.yaml)
@@ -258,7 +247,7 @@ If you want to do add the repository manually, please follow the procedure highl
 ![amd64][amd64-badge]
 ![ingress][ingress-badge]
 
-✓ ![image](https://api.iconify.design/mdi/robot-happy.svg) [Claude Desktop](claude_desktop/) : Claude Desktop with Headroom MCP context compression and RTK acceleration
+✓ ![image](https://api.iconify.design/mdi/robot-happy.svg) [Claude Desktop](claude_desktop/) : Claude Desktop streamed through a browser with LinuxServer Selkies
 
   ![Version](https://img.shields.io/badge/dynamic/yaml?label=Version&query=%24.version&url=https%3A%2F%2Fraw.githubusercontent.com%2Falexbelgium%2Fhassio-addons%2Fmaster%2Fclaude_desktop%2Fconfig.yaml)
 ![Update](https://img.shields.io/badge/dynamic/json?label=Updated&query=%24.last_update&url=https%3A%2F%2Fraw.githubusercontent.com%2Falexbelgium%2Fhassio-addons%2Fmaster%2Fclaude_desktop%2Fupdater.json)
@@ -313,7 +302,6 @@ If you want to do add the repository manually, please follow the procedure highl
 ✓  [Elasticsearch server](elasticsearch/) : Free and Open, Distributed, RESTful Search Engine
 
   ![Version](https://img.shields.io/badge/dynamic/yaml?label=Version&query=%24.version&url=https%3A%2F%2Fraw.githubusercontent.com%2Falexbelgium%2Fhassio-addons%2Fmaster%2Felasticsearch%2Fconfig.yaml)
-![Update](https://img.shields.io/badge/dynamic/json?label=Updated&query=%24.last_update&url=https%3A%2F%2Fraw.githubusercontent.com%2Falexbelgium%2Fhassio-addons%2Fmaster%2Felasticsearch%2Fupdater.json)
 ![aarch64][aarch64-badge]
 ![amd64][amd64-badge]
 
@@ -520,7 +508,7 @@ If you want to do add the repository manually, please follow the procedure highl
 ![smb][smb-badge]
 ![localdisks][localdisks-badge]
 
-✓ ![image](https://api.iconify.design/mdi/billiards-rack.svg) [Jellyfin (71957x) NAS](jellyfin/) : A free Software Media System that puts you in control of managing and streaming your media
+✓ ![image](https://api.iconify.design/mdi/billiards-rack.svg) [Jellyfin NAS](jellyfin/) : A free Software Media System that puts you in control of managing and streaming your media
 
   ![Version](https://img.shields.io/badge/dynamic/yaml?label=Version&query=%24.version&url=https%3A%2F%2Fraw.githubusercontent.com%2Falexbelgium%2Fhassio-addons%2Fmaster%2Fjellyfin%2Fconfig.yaml)
 ![Update](https://img.shields.io/badge/dynamic/json?label=Updated&query=%24.last_update&url=https%3A%2F%2Fraw.githubusercontent.com%2Falexbelgium%2Fhassio-addons%2Fmaster%2Fjellyfin%2Fupdater.json)
@@ -583,7 +571,7 @@ If you want to do add the repository manually, please follow the procedure highl
 ![aarch64][aarch64-badge]
 ![amd64][amd64-badge]
 
-✓ ![image](https://api.iconify.design/mdi/movie-search.svg) [Maintainerr](maintainerr/) : Rule-based media cleanup tool for Plex, Jellyfin (71957x) and Emby. Creates collections and optionally deletes unwatched content.
+✓ ![image](https://api.iconify.design/mdi/movie-search.svg) [Maintainerr](maintainerr/) : Rule-based media cleanup tool for Plex, Jellyfin and Emby. Creates collections and optionally deletes unwatched content.
 
   ![Version](https://img.shields.io/badge/dynamic/yaml?label=Version&query=%24.version&url=https%3A%2F%2Fraw.githubusercontent.com%2Falexbelgium%2Fhassio-addons%2Fmaster%2Fmaintainerr%2Fconfig.yaml)
 ![Update](https://img.shields.io/badge/dynamic/json?label=Updated&query=%24.last_update&url=https%3A%2F%2Fraw.githubusercontent.com%2Falexbelgium%2Fhassio-addons%2Fmaster%2Fmaintainerr%2Fupdater.json)
@@ -897,7 +885,7 @@ If you want to do add the repository manually, please follow the procedure highl
 ![smb][smb-badge]
 ![localdisks][localdisks-badge]
 
-✓ ![image](https://api.iconify.design/mdi/movie-search.svg) [Seerr](seerr/) : Open-source media request and discovery manager for Jellyfin (71957x), Plex, and Emby
+✓ ![image](https://api.iconify.design/mdi/movie-search.svg) [Seerr](seerr/) : Open-source media request and discovery manager for Jellyfin, Plex, and Emby
 
   ![Version](https://img.shields.io/badge/dynamic/yaml?label=Version&query=%24.version&url=https%3A%2F%2Fraw.githubusercontent.com%2Falexbelgium%2Fhassio-addons%2Fmaster%2Fseerr%2Fconfig.yaml)
 ![Update](https://img.shields.io/badge/dynamic/json?label=Updated&query=%24.last_update&url=https%3A%2F%2Fraw.githubusercontent.com%2Falexbelgium%2Fhassio-addons%2Fmaster%2Fseerr%2Fupdater.json)

aurral/CHANGELOG.md

@@ -1,7 +1,4 @@
  
-## 1.76.52 (2026-07-11)
-- Update to latest version from lklynet/aurral (changelog : https://github.com/lklynet/aurral/releases)
- 
 ## 1.76.51 (2026-06-17)
 - Update to latest version from lklynet/aurral (changelog : https://github.com/lklynet/aurral/releases)
 ## 1.76.49 (2026-06-05)

aurral/config.yaml

@@ -1,5 +1,5 @@
 name: Aurral
-version: "1.76.52"
+version: "1.76.51"
 slug: aurral
 description: >-
   Self-hosted music discovery, request management, flows, and playlist

aurral/updater.json

@@ -1,9 +1,9 @@
 {
-  "last_update": "2026-07-11",
+  "last_update": "2026-06-17",
   "repository": "alexbelgium/hassio-addons",
   "slug": "aurral",
   "source": "github",
   "upstream_repo": "lklynet/aurral",
-  "upstream_version": "1.76.52",
+  "upstream_version": "1.76.51",
   "github_beta": false
 }

birdnet-go-dev/CHANGELOG.md

@@ -1,5 +1,3 @@
-## source-20260714 (14-07-2026)
-- Minor bugs fixed
 ## source-20260709 (09-07-2026)
 - Minor bugs fixed
 ## source-20260708-4 (08-07-2026)

birdnet-go-dev/config.yaml

@@ -127,5 +127,5 @@ slug: birdnet-go-dev
 udev: true
 url: https://github.com/alexbelgium/hassio-addons
 usb: true
-version: "source-20260714"
+version: "source-20260709"
 video: true

birdnet-go/CHANGELOG.md

@@ -1,6 +1,3 @@
- 
-## 20260712 (2026-07-13)
-- Update to latest version from tphakala/birdnet-go (changelog : https://github.com/tphakala/birdnet-go/releases)
 ## nightly-20260615-4 (09-07-2026)
 - Minor bugs fixed
 ## nightly-20260615-3 (05-07-2026)

birdnet-go/config.yaml

@@ -128,4 +128,4 @@ slug: birdnet-go
 udev: true
 url: https://github.com/alexbelgium/hassio-addons/tree/master/birdnet-go
 usb: true
-version: "20260712"
+version: "nightly-20260615-4"

birdnet-go/updater.json

@@ -2,10 +2,10 @@
   "github_beta": true,
   "github_exclude": "-4",
   "github_fulltag": true,
-  "last_update": "2026-07-13",
+  "last_update": "2026-06-17",
   "repository": "alexbelgium/hassio-addons",
   "slug": "birdnet-go",
   "source": "github",
   "upstream_repo": "tphakala/birdnet-go",
-  "upstream_version": "20260712"
+  "upstream_version": "nightly-20260615"
 }

birdnet-pi/CHANGELOG.md

@@ -1,6 +1,3 @@
-## 2026.07.10-1 (10-07-2026)
-- Fix standalone (no-Supervisor) mode: strip `sudo` from BirdNET-Pi scripts at build time (the previous hook ran before the repo was cloned, so `sudo` remained and broke service/WebUI actions run by non-sudoers users such as `caddy`/`abc`)
-- Ensure `/run/php` exists before starting PHP-FPM so the WebUI starts even when `/run` is a fresh tmpfs
 ## 2026.07.10 (10-07-2026)
 - Minor bugs fixed
 ## 2026.06.01 (19-06-2026)

birdnet-pi/Dockerfile

@@ -74,6 +74,17 @@ RUN \
     curl -f -L -s -S "https://raw.githubusercontent.com/alexbelgium/BirdNET-Pi/main/newinstaller.sh" -o /newinstaller.sh && \
     chmod 777 /newinstaller.sh && \
     \
+    # Use installer to modify other scripts
+    #######################################
+    # Define file
+    sed -i "1a /./newinstallermod.sh" /newinstaller.sh && \
+    echo '#!/bin/bash' >> /newinstallermod.sh && \
+    # Remove all instances of sudo from all other scripts
+    echo 'for file in $(grep -srl "sudo" $HOME/BirdNET-Pi/scripts); do sed -i "s|sudo ||" "$file"; done' >> /newinstallermod.sh && \
+    echo 'for file in $(grep -srl "my_dir" $HOME/BirdNET-Pi/scripts); do sed -i "s|\$my_dir|/config|" "$file"; done' >> /newinstallermod.sh && \
+    # Set permission
+    chmod +x /newinstallermod.sh && \
+    \
     # Modify installer
     ##################
     # Use my repository
@@ -99,16 +110,6 @@ RUN \
     # Execute installer
     /./newinstaller.sh && \
     \
-    # Remove sudo from the installed BirdNET-Pi scripts.
-    # Inside the container everything already runs with the privileges it needs
-    # (root during init, user "pi" for the services), so "sudo" is never required.
-    # Leaving it in breaks any script invoked by a user that is not in sudoers -
-    # e.g. php-fpm's "caddy" user driving the WebUI System Controls, or the "abc"
-    # user - which is what prevented BirdNET-Pi from working in standalone
-    # (no-Supervisor) mode. This must run AFTER the installer has cloned the repo;
-    # the previous build-time hook ran before the clone and was therefore a no-op.
-    for file in $(grep -srlF "sudo " "$HOME/BirdNET-Pi/scripts"); do sed -i "s|sudo ||g" "$file"; done && \
-    \
     # Install dateparser and resampy, upgrade numpy
     $PYTHON_VIRTUAL_ENV /usr/bin/pip3 install dateparser resampy && \
     \

birdnet-pi/config.yaml

@@ -116,5 +116,5 @@ tmpfs: true
 udev: true
 url: https://github.com/alexbelgium/hassio-addons/tree/master/birdnet-pi
 usb: true
-version: 2026.07.10-1
+version: 2026.07.10
 video: true

birdnet-pi/rootfs/custom-services.d/00-php_pfm.sh

@@ -4,14 +4,6 @@
 # Correct /config permissions after startup
 chown pi:pi /config
 
-# Ensure the PHP-FPM runtime directory exists. It is normally created by
-# systemd-tmpfiles (/usr/lib/tmpfiles.d/php*-fpm.conf), which does not run in
-# this container - so on a fresh/tmpfs /run the socket cannot be bound and the
-# WebUI never starts. Create it here so the web stack works with or without
-# Home Assistant Supervisor.
-mkdir -p /run/php
-chown www-data:www-data /run/php 2> /dev/null || true
-
 # Set timezone without requiring Home Assistant Supervisor or D-Bus.
 TZ_VALUE="${TZ:-}"
 if [[ -S /var/run/dbus/system_bus_socket ]] && command -v timedatectl > /dev/null 2>&1; then

birdnet-pipy/CHANGELOG.md

@@ -1,10 +1,4 @@
  
-## 0.8.4 (2026-07-13)
-- Update to latest version from Suncuss/BirdNET-PiPy (changelog : https://github.com/Suncuss/BirdNET-PiPy/releases)
- 
-## 0.8.3 (2026-07-11)
-- Update to latest version from Suncuss/BirdNET-PiPy (changelog : https://github.com/Suncuss/BirdNET-PiPy/releases)
- 
 ## 0.8.2.1 (2026-07-05)
 - Re-tag of 0.8.2-1 with no content change. Home Assistant compares add-on versions with semver semantics, where a `-N` suffix counts as a *pre-release* and sorts **below** the base version — so users already on 0.8.2 saw the 0.8.2-1 nginx fix as "Up-to-date" with the Update button disabled. Four-segment `0.8.2.1` sorts above both `0.8.2` and `0.8.2-1` (and below the next upstream `0.8.3`), so the update becomes installable everywhere.
 

birdnet-pipy/config.yaml

@@ -96,4 +96,4 @@ schema:
   ssl: bool?
 slug: birdnet-pipy
 url: https://github.com/alexbelgium/hassio-addons/tree/master/birdnet-pipy
-version: "0.8.4"
+version: "0.8.2.1"

birdnet-pipy/updater.json

@@ -1,8 +1,8 @@
 {
-  "last_update": "2026-07-13",
+  "last_update": "2026-07-04",
   "repository": "alexbelgium/hassio-addons",
   "slug": "birdnet-pipy",
   "source": "github",
   "upstream_repo": "Suncuss/BirdNET-PiPy",
-  "upstream_version": "0.8.4"
+  "upstream_version": "0.8.2"
 }

browser_brave/CHANGELOG.md

@@ -1,7 +1,4 @@
  
-## 1.92.139-ls112 (2026-07-11)
-- Update to latest version from linuxserver/docker-brave (changelog : https://github.com/linuxserver/docker-brave/releases)
- 
 ## 1.92.134-ls109 (2026-07-04)
 - Update to latest version from linuxserver/docker-brave (changelog : https://github.com/linuxserver/docker-brave/releases)
  

browser_brave/config.yaml

@@ -69,5 +69,5 @@ slug: brave
 tmpfs: true
 udev: true
 url: https://github.com/alexbelgium/hassio-addons
-version: "1.92.139-ls112"
+version: "1.92.134-ls109"
 video: true

browser_brave/updater.json

@@ -1,9 +1,9 @@
 {
   "github_fulltag": "true",
-  "last_update": "2026-07-11",
+  "last_update": "2026-07-04",
   "repository": "alexbelgium/hassio-addons",
   "slug": "brave",
   "source": "github",
   "upstream_repo": "linuxserver/docker-brave",
-  "upstream_version": "1.92.139-ls112"
+  "upstream_version": "1.92.134-ls109"
 }

browser_chromium/CHANGELOG.md

@@ -1,7 +1,4 @@
  
-## version-30a7c401 (2026-07-11)
-- Update to latest version from linuxserver/docker-chromium (changelog : https://github.com/linuxserver/docker-chromium/releases)
- 
 ## version-7148c2a3 (2026-07-04)
 - Update to latest version from linuxserver/docker-chromium (changelog : https://github.com/linuxserver/docker-chromium/releases)
  

browser_chromium/config.yaml

@@ -71,5 +71,5 @@ slug: chromium
 tmpfs: true
 udev: true
 url: https://github.com/alexbelgium/hassio-addons
-version: "version-30a7c401"
+version: "version-7148c2a3"
 video: true

browser_chromium/updater.json

@@ -1,9 +1,9 @@
 {
   "github_fulltag": "true",
-  "last_update": "2026-07-11",
+  "last_update": "2026-07-04",
   "repository": "alexbelgium/hassio-addons",
   "slug": "chromium",
   "source": "github",
   "upstream_repo": "linuxserver/docker-chromium",
-  "upstream_version": "version-30a7c401"
+  "upstream_version": "version-7148c2a3"
 }

claude_desktop/CHANGELOG.md

@@ -1,58 +1,3 @@
-## 1.23 (15-07-2026)
-
-- Expose `SUDO_PASSWORD`, per LinuxServer.io's base-image convention: setting it grants the `abc` user sudo access gated by that password. Sudo access stays disabled by default when left unset. Passed straight through by the existing option-to-env-var mechanism; no rootfs changes needed.
-
-## 1.21 (15-07-2026)
-
-- Fix Claude Code bypass permissions being rejected when the add-on uses its default root `PUID`.
-- In `permission_mode: bypass`, remap the shared `abc` Desktop runtime to an unused non-root UID before storage ownership and Selkies startup, while retaining its configured primary group for mounted-path access.
-- Make folder setup and final Claude configuration ownership follow the effective `abc` identity instead of the configured root UID.
-- Drop root console invocations of the add-on's `/usr/local/bin/claude` wrapper to the non-root `abc` runtime before passing `--dangerously-skip-permissions`.
-- Extend `claude-tools-doctor.sh` with configured/effective UID and GID checks for bypass mode.
-
-## 1.20 (15-07-2026)
-
-- Complete the TokenSave Claude Code integration at startup: install its MCP server, permissions, PreToolUse/UserPromptSubmit/Stop hooks, global guidance, and Git synchronization hooks instead of registering only `tokensave serve`.
-- Add `tokensave_project_paths` for explicit per-repository initialization and incremental synchronization; no repositories are scanned or indexed unless listed.
-- Route PATH-based Claude Code launches through the already-supervised Headroom proxy by default with a recursion-safe `/usr/local/bin/claude` wrapper; fall back to the official binary when the proxy is unavailable.
-- Pass the local proxy URL explicitly to the Headroom MCP server, while retaining MCP-only integration for the Desktop Electron application.
-- Keep the unauthenticated Headroom dashboard container-local by default; add `expose_headroom_dashboard` and leave port `8787/tcp` unmapped until explicitly enabled.
-- Fix the hourly gains report so Headroom no longer suppresses RTK output, add TokenSave gains, and gate each tool on its actual add-on option.
-- Add `claude-tools-doctor.sh` to inspect binaries, redacted MCP registrations, hooks, proxy health, routing, project indexes, and gains.
-- Install local validation tools (`jq`, `shellcheck`, `yamllint`, current `hadolint`, and current `actionlint`) to reduce avoidable CI round-trips.
-- Disable the unpinned third-party Caveman startup installer by default; it remains opt-in.
-
-## 1.19 (14-07-2026)
-- Minor bugs fixed
-## 1.18 (14-07-2026)
-
-- **Breaking:** remove the standalone Claude Code web terminal (ttyd/tmux service, port `7681`, and the `enable_terminal`, `terminal_username`, `terminal_password`, `terminal_workspace` options). The add-on is now built purely around Claude Desktop; Claude Code remains installed and powers Desktop cowork/dispatch sessions with the RTK hook, Caveman, and MCP servers intact. If the add-on refuses to start after the update, open its Configuration tab and re-save to drop the removed options.
-- Remove the `claude-direct` and `claude-headroom` terminal wrapper scripts and the unused `ha_smart_context` and `dangerously_skip_permissions` options.
-- Fix the Headroom dashboard being unreachable at `http://<host>:8787/dashboard`: the supervised proxy only listened on `127.0.0.1`; it now binds `0.0.0.0` so the mapped port works.
-- Fix dispatch/remote sessions and sign-in persistence: install the missing `gnome-keyring` package. The existing keyring bootstrap silently no-oped without it, leaving Electron `safeStorage` unavailable ("cannot store allowlist cache"), so auth tokens and dispatch permission grants were lost on restart.
-- Add the tokensave code-intelligence MCP server (pinned 7.2.0, built from source like RTK), registered for both Claude Desktop and Claude Code; disable with `install_tokensave: false`.
-- Implement the Home Assistant MCP bridge for real: `enable_ha_mcp` plus new `ha_mcp_url`/`ha_mcp_token` options register Home Assistant's MCP Server integration in Claude through `mcp-proxy`, using the integration's stateless Streamable HTTP endpoint (`/api/mcp`).
-- Write the Claude configuration files with `0600` permissions, since they hold the Home Assistant access token in clear text.
-- Restrict the build-time `chmod +x` pass to the directories the add-on actually ships scripts in instead of traversing the whole image.
-- Register add-on-managed MCP servers in Claude Code's `~/.claude.json` as well as Claude Desktop's config, without clobbering user-customized entries.
-- Install `uv` and use it for the `additional_pip` option for much faster package installs.
-
-## 1.16 (14-07-2026)
-- Minor bugs fixed
-## 1.15 (13-07-2026)
-- Minor bugs fixed
-  
-## ubunturesolute-version-6dc44b0e (2026-07-13)
-- Update to latest version from linuxserver/docker-baseimage-selkies (changelog : https://github.com/linuxserver/docker-baseimage-selkies/releases)
-## 1.14 (10-07-2026)
-
-- Build pinned RTK 0.43.0 source on Debian Bookworm for both architectures instead of installing the upstream arm64 release binary, which requires GLIBC 2.39 and cannot run in the add-on image.
-- Execute `rtk --version` inside the final image during the Docker build so future ABI incompatibilities fail CI instead of surfacing at runtime.
-- Validate the final Bookworm-built RTK binary in a native aarch64 image build.
-- Correct the repository PR checks so changed changelog paths are exported and aarch64 images are built explicitly for `linux/arm64`.
-
-## debiantrixie-version-c55d3809 (2026-07-11)
-- Update to latest version from linuxserver/docker-baseimage-selkies (changelog : https://github.com/linuxserver/docker-baseimage-selkies/releases)
 ## 1.13 (10-07-2026)
 
 - Add the official Claude Code stable package, `tmux`, `ripgrep`, and a pinned upstream `ttyd` binary for both supported architectures.

claude_desktop/Dockerfile

@@ -9,32 +9,7 @@
 
 ARG BUILD_FROM
 ARG BUILD_VERSION
-ARG RTK_VERSION="v0.43.0"
-ARG RTK_COMMIT="5a7880d404db8364d602f2ecdc41dd790f64013f"
-ARG TOKENSAVE_VERSION="7.2.0"
-
-# The upstream aarch64 release is cross-built on ubuntu-latest and requires
-# GLIBC 2.39. Build the pinned source on Bookworm instead so it is compatible
-# with the add-on runtime on both supported architectures.
-FROM rust:1.91-bookworm AS rtk-builder
-ARG RTK_VERSION
-ARG RTK_COMMIT
-RUN git clone --depth 1 --branch "${RTK_VERSION}" https://github.com/rtk-ai/rtk.git /src/rtk && \
-    test "$(git -C /src/rtk rev-parse HEAD)" = "${RTK_COMMIT}" && \
-    cd /src/rtk && \
-    cargo build --release --locked && \
-    install -D -m 0755 target/release/rtk /out/rtk && \
-    /out/rtk --version
-
-# tokensave ships no Bookworm-compatible prebuilt binary either; build the pinned
-# crates.io release from source so GLIBC matches the add-on runtime.
-FROM rust:1.91-bookworm AS tokensave-builder
-ARG TOKENSAVE_VERSION
-RUN cargo install tokensave --version "${TOKENSAVE_VERSION}" --locked --root /out && \
-    /out/bin/tokensave --version
-
 FROM ${BUILD_FROM}
-ARG BUILD_ARCH
 
 ##################
 # 2 Modify Image #
@@ -70,21 +45,17 @@ RUN curl -fsSL --retry 3 --retry-delay 2 \
 # 3 Install apps #
 ##################
 
-# Add rootfs. Only the directories this add-on ships scripts in are traversed, so the chmod
-# cannot alter executables elsewhere in the image.
+# Add rootfs
 COPY rootfs/ /
-RUN find /etc/cont-init.d /etc/s6-overlay /defaults /usr/local/bin -type f \
-        \( -name "*.sh" -o -name "run" -o -name "finish" \) -print -exec chmod +x {} \; && \
-    chmod +x /usr/local/bin/claude
+RUN find . -type f \( -name "*.sh" -o -name "run" -o -name "finish" \) -print -exec chmod +x {} \; && \
+    chmod +x /usr/local/bin/claude-direct /usr/local/bin/claude-headroom /usr/local/bin/claude-terminal-shell
 
 # Uses /bin for compatibility purposes
 # hadolint ignore=DL4005
 RUN if [ ! -f /bin/sh ] && [ -f /usr/bin/sh ]; then ln -s /usr/bin/sh /bin/sh; fi && \
     if [ ! -f /bin/bash ] && [ -f /usr/bin/bash ]; then ln -s /usr/bin/bash /bin/bash; fi
 
-# Install Claude Desktop, Claude Code, Python tooling, and lightweight local validators.
-# gnome-keyring provides the Secret Service backend Electron safeStorage needs to persist
-# sign-in and dispatch grants.
+# Install Claude Desktop, Claude Code, browser-terminal tooling, and Python tooling
 RUN install -d -m 0755 /etc/apt/keyrings && \
     curl -fsSLo /usr/share/keyrings/claude-desktop-archive-keyring.asc https://downloads.claude.ai/claude-desktop/key.asc && \
     curl -fsSLo /etc/apt/keyrings/claude-code.asc https://downloads.claude.ai/keys/claude-code.asc && \
@@ -100,53 +71,33 @@ RUN install -d -m 0755 /etc/apt/keyrings && \
         git \
         gh \
         ripgrep \
-        jq \
-        shellcheck \
-        yamllint && \
-    test -x /usr/bin/claude && \
+        tmux && \
     apt-get clean && \
     rm -rf /var/lib/apt/lists/*
 
-# Install the current upstream hadolint and actionlint releases for both supported
-# architectures. The GitHub release API resolves the latest asset at build time, so these
-# developer tools are intentionally not version-pinned.
+# ttyd is not packaged in Debian bookworm. Install the pinned upstream static binary.
+ARG TTYD_VERSION="1.7.7"
 RUN set -eux; \
-    case "${BUILD_ARCH}" in \
-        amd64) hadolint_arch="x86_64"; actionlint_arch="amd64" ;; \
-        aarch64) hadolint_arch="arm64"; actionlint_arch="arm64" ;; \
-        *) echo "Unsupported validation-tools architecture: ${BUILD_ARCH}" >&2; exit 1 ;; \
+    case "$(dpkg --print-architecture)" in \
+        amd64) ttyd_arch="x86_64" ;; \
+        arm64) ttyd_arch="aarch64" ;; \
+        *) echo "Unsupported architecture for ttyd: $(dpkg --print-architecture)" >&2; exit 1 ;; \
     esac; \
-    hadolint_name="hadolint-linux-${hadolint_arch}"; \
-    hadolint_url="$(curl -fsSL https://api.github.com/repos/hadolint/hadolint/releases/latest \
-        | jq -r --arg name "${hadolint_name}" '.assets[] | select(.name == $name) | .browser_download_url' \
-        | head -n 1)"; \
-    test -n "${hadolint_url}"; \
-    curl -fsSL --retry 3 --retry-delay 2 -o /usr/local/bin/hadolint "${hadolint_url}"; \
-    chmod 0755 /usr/local/bin/hadolint; \
-    actionlint_suffix="_linux_${actionlint_arch}.tar.gz"; \
-    actionlint_url="$(curl -fsSL https://api.github.com/repos/rhysd/actionlint/releases/latest \
-        | jq -r --arg suffix "${actionlint_suffix}" '.assets[] | select(.name | endswith($suffix)) | .browser_download_url' \
-        | head -n 1)"; \
-    test -n "${actionlint_url}"; \
-    curl -fsSL --retry 3 --retry-delay 2 -o /tmp/actionlint.tar.gz "${actionlint_url}"; \
-    tar -xzf /tmp/actionlint.tar.gz -C /tmp actionlint; \
-    install -m 0755 /tmp/actionlint /usr/local/bin/actionlint; \
-    rm -f /tmp/actionlint /tmp/actionlint.tar.gz; \
-    hadolint --version; \
-    actionlint -version
+    curl -fsSL --retry 3 --retry-delay 2 \
+        -o /usr/local/bin/ttyd \
+        "https://github.com/tsl0922/ttyd/releases/download/${TTYD_VERSION}/ttyd.${ttyd_arch}"; \
+    chmod 0755 /usr/local/bin/ttyd; \
+    /usr/local/bin/ttyd --version
 
-# Copy the pinned Bookworm-built RTK and tokensave binaries and execute them in the final
-# image. This makes an ABI mismatch fail the image build instead of surfacing at runtime.
-COPY --from=rtk-builder /out/rtk /usr/local/bin/rtk
-COPY --from=tokensave-builder /out/bin/tokensave /usr/local/bin/tokensave
-RUN /usr/local/bin/rtk --version && /usr/local/bin/tokensave --version
-
-# Install only the Headroom proxy, code-compression, and MCP features used by this add-on,
-# plus mcp-proxy (stdio->HTTP bridge for the Home Assistant MCP server) and uv (fast
-# installer used for the additional_pip option).
+# Install only the Headroom proxy, code-compression, and MCP features used by this add-on.
 RUN apt-get update && \
     apt-get install -y --no-install-recommends nodejs && \
-    pip3 install --break-system-packages "headroom-ai[proxy,code,mcp]" mcp-proxy uv && \
+    pip3 install --break-system-packages "headroom-ai[proxy,code,mcp]" && \
+    curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh -o /tmp/rtk-install.sh && \
+    HOME=/root sh /tmp/rtk-install.sh && \
+    rm /tmp/rtk-install.sh && \
+    if [ -x /root/.local/bin/rtk ] && [ ! -x /usr/local/bin/rtk ]; then mv /root/.local/bin/rtk /usr/local/bin/rtk; fi && \
+    if [ -x /usr/local/bin/rtk ]; then chmod +x /usr/local/bin/rtk; else echo "rtk binary was not installed on PATH"; exit 1; fi && \
     apt-get clean && \
     rm -rf /var/lib/apt/lists/* /root/.cache
 
@@ -194,6 +145,7 @@ CMD [ "/ha_entrypoint.sh" ]
 # 5 Labels #
 ############
 
+ARG BUILD_ARCH
 ARG BUILD_DATE
 ARG BUILD_DESCRIPTION
 ARG BUILD_NAME

claude_desktop/README.md

@@ -4,9 +4,8 @@
 ![Supports amd64 Architecture][amd64-shield]
 ![Project Maintenance][maintenance-shield]
 
-Run Claude Desktop in a LinuxServer.io Selkies add-on, with Headroom context
-compression, RTK Bash-output acceleration, and TokenSave semantic code
-intelligence wired in by default.
+Run Claude Desktop and an optional persistent Claude Code web terminal in one
+LinuxServer.io Selkies add-on.
 
 ## Installation
 
@@ -21,201 +20,151 @@ currently does not include Computer Use or dictation.
 
 ## Architecture
 
-Everything is built around the Claude Desktop app. Claude Code is installed in
-the same image but is not exposed as a standalone service: Claude Desktop's
-cowork and dispatch sessions run it internally, and they pick up the shared
-Claude Code configuration (`~/.claude`), hooks, MCP servers, permissions, and
-PATH tools.
+Claude Desktop and Claude Code run as separate clients inside the same add-on.
+They share the configured persistent home directory, Git credentials,
+repositories, Claude Code configuration, Headroom storage, and RTK
+configuration, but they do not share or hand off a conversation.
 
 - **Claude Desktop** uses Headroom through its MCP tools.
-- **Claude Code sessions inside Desktop** get the same MCP servers, permission
-  mode, and RTK/TokenSave hooks through the shared Claude Code configuration.
-- PATH-based Claude Code launches are routed through the supervised Headroom
-  proxy when `headroom_wrap_claude_code` is enabled. If a Desktop release calls
-  `/usr/bin/claude` directly, the session remains functional and still has the
-  shared permission mode and Headroom MCP tools, but transparent proxy
-  compression cannot be injected.
-- When `permission_mode: bypass` is selected while `PUID` is `0`, the add-on
-  automatically remaps the shared `abc` desktop account to an unused non-root
-  UID before Selkies and Claude Desktop start. Claude Code refuses bypass mode
-  under an effective root UID.
-- **gnome-keyring** provides the Secret Service backend Electron needs to
-  persist sign-in and dispatch permission grants across restarts.
-
-## Optimization layers
-
-The three bundled optimization tools are complementary:
-
-- **RTK** rewrites supported Bash commands so Claude receives compact output.
-- **TokenSave** builds a local semantic graph for explicitly selected code
-  repositories and steers Claude away from repeated Explore/Grep/Read fan-out.
-- **Headroom** transparently compresses proxied Claude Code traffic and also
-  exposes on-demand compress/retrieve/statistics MCP tools to Claude Desktop.
-
-TokenSave's complete Claude integration is installed at startup: MCP server,
-permissions, PreToolUse/UserPromptSubmit/Stop hooks, global prompt rules, and
-Git synchronization hooks. A repository is indexed only when it is listed in
-`tokensave_project_paths`; no automatic filesystem scan is performed.
+- **Claude Code** uses Headroom's supported `headroom wrap claude` integration.
+- **RTK** filters Claude Code Bash output through its `PreToolUse` hook.
+- **tmux** keeps the terminal session running when the browser disconnects.
 
 ## Features
 
-- Claude Desktop in single-app Selkies mode with Home Assistant ingress.
-- Official Claude Code stable package powering Desktop cowork/dispatch
-  sessions.
+- Claude Desktop in single-app Selkies mode.
+- Home Assistant ingress support for Claude Desktop.
+- Official Claude Code stable package installed in the same image.
+- Optional authenticated `ttyd` web terminal on port `7681`.
+- Persistent `tmux` session shared by reconnecting terminal clients.
 - Persistent `$HOME` at the configured `data_location` (default `/data/data`),
   preserving Desktop and Claude Code state across restarts.
-- Persistent sign-in through a bundled, auto-unlocked gnome-keyring.
-- Configurable Claude Code permissions: strict prompts, automatic safe-action
-  approval, or explicit full bypass for trusted installations.
-- Automatic non-root runtime enforcement for bypass mode, including root-console
-  wrapper launches.
 - Optional runtime Claude Desktop updates from Anthropic's apt repository.
-- Optional extra apt and pip package installation (pip installs use `uv`).
-- Baked-in `git`, GitHub CLI (`gh`), `ripgrep`, `jq`, `shellcheck`, `yamllint`,
-  `hadolint`, and `actionlint`.
+- Optional extra apt and pip package installation.
+- Baked-in `git`, GitHub CLI (`gh`), `ripgrep`, and terminal tooling.
 - Custom script support through the repository standard `claude_desktop.sh`.
-- Bundled optimization tools: Headroom, RTK, and TokenSave; Caveman remains
-  available as an opt-in plugin.
-- Optional Home Assistant MCP bridge so Claude can query and control Home
-  Assistant.
-- Independent hourly savings reports for Headroom, RTK, and TokenSave.
-- `claude-tools-doctor.sh` diagnostics for binaries, routing, hooks, MCP
-  registrations, project indexes, proxy health, permissions, runtime identity,
-  and gains.
+- Optional bundled Claude Code optimization tools: Headroom, RTK, and Caveman.
+- Headroom dashboard exposed on mapped port `8787` when enabled.
 - Low-power defaults for GPU mapping, Selkies frame rate, and volatile caches.
 
+## Claude Code terminal setup
+
+The terminal service is enabled in the add-on configuration but remains
+unavailable until authentication is configured. Port `7681` is not mapped by
+default.
+
+1. Set a unique `terminal_password`. The existing `PASSWORD` option is accepted
+   only as a compatibility fallback.
+2. Optionally set `terminal_username` and `terminal_workspace`.
+3. Map container port `7681` to a host port in the add-on **Network** section.
+4. Restart the add-on.
+5. Reach `http://<home-assistant-host>:7681` only through an encrypted VPN or an
+   HTTPS reverse proxy, then sign in with the configured terminal credentials.
+
+The terminal opens in a persistent tmux session. Closing the browser detaches
+from tmux rather than terminating commands that are already running.
+
+Start the optimized Claude Code path with:
+
+```shell
+claude-headroom
+```
+
+This reuses the supervised Headroom proxy on `127.0.0.1:8787` and launches
+Claude Code with the required routing. Headroom is told not to install RTK
+because the add-on already maintains the RTK hook in
+`~/.claude/settings.json`.
+
+To bypass Headroom for troubleshooting, run:
+
+```shell
+claude-direct
+```
+
+Running `claude` directly is equivalent to the direct path. The first Claude
+Code launch may require its own account authentication; Desktop and Claude Code
+store separate client credentials even though both use the configured
+persistent home directory.
+
+### Multiple concurrent clients
+
+Every browser connection attaches to the same tmux session. Concurrent clients
+therefore see the same terminal, keystrokes, and resize events. This is useful
+for reconnecting to one long-running session, but it is not an isolated
+multi-user terminal.
+
+### Terminal user and permissions
+
+The service drops privileges to the LinuxServer `abc` account before starting
+ttyd. The effective numeric UID and GID follow the configured `PUID` and `PGID`.
+Using `PUID: 0` can provide root-equivalent access inside the add-on; use a
+non-zero UID/GID where your storage permissions allow it.
+
+The configured workspace must resolve to the persistent home directory or a
+subdirectory of `/share`, `/media`, `/mnt`, `/data`, or `/config`. Existing
+directories are never re-owned by the terminal service and must already be
+readable, writable, and searchable by `abc`.
+
+### Terminal security
+
+The direct ttyd endpoint uses HTTP Basic Authentication without TLS.
+Credentials and terminal traffic are unencrypted on the network. ttyd also
+receives its Basic Authentication credential as a process argument, so it is
+visible to processes with sufficient access inside the container.
+
+Do not expose port `7681` directly to the public internet. Use a VPN such as
+WireGuard or Tailscale, or place the endpoint behind an HTTPS reverse proxy.
+Use a unique `terminal_password` rather than reusing the Selkies `PASSWORD`.
+
 ## Options
 
 | Option | Default | Description |
 | ------ | ------- | ----------- |
-| `PUID` / `PGID` | `0` / `0` | Numeric user and group applied by LinuxServer initialization. In bypass mode, a root `PUID` is automatically replaced at runtime by an unused non-root UID while the configured group is retained. |
+| `PUID` / `PGID` | `0` / `0` | Numeric user and group applied by the LinuxServer initialization. |
 | `TZ` | | Optional timezone, for example `Europe/Brussels`. |
 | `KEYBOARD` | | Optional Selkies keyboard layout. |
-| `PASSWORD` | | Optional password for direct Selkies ports. |
-| `SUDO_PASSWORD` | | LinuxServer.io convention: grants the `abc` user sudo access gated by this password. Sudo access is disabled by default when left unset. |
+| `PASSWORD` | | Optional password for direct Selkies ports and compatibility fallback for terminal authentication. |
 | `DRINODE` | | Optional GPU device override for Selkies. |
 | `DNS_server` | `8.8.8.8` | DNS server used by the standard DNS module. |
 | `auto_update` | `true` | Upgrade `claude-desktop` from Anthropic's apt repository at startup. |
-| `permission_mode` | `auto` | Claude Code permission policy: `strict`, `auto`, or `bypass`. |
-| `install_headroom` | `true` | Register Headroom MCP and run the supervised local proxy. |
-| `headroom_wrap_claude_code` | `true` | Route PATH-based Claude Code launches through the already-running Headroom proxy. |
-| `expose_headroom_dashboard` | `false` | Bind Headroom to all interfaces. Port `8787/tcp` must also be mapped manually. |
-| `install_rtk` | `true` | Configure RTK's Claude Code `PreToolUse` Bash hook. |
-| `install_tokensave` | `true` | Install TokenSave's complete global Claude integration. |
-| `tokensave_project_paths` | `[]` | Explicit absolute Git repository paths to initialize or sync at startup. |
-| `install_caveman` | `false` | Install the third-party Caveman Claude Code plugin at startup. |
-| `enable_tools_health_report` | `true` | Write independent Headroom, RTK, and TokenSave gains to the add-on log hourly. |
+| `enable_terminal` | `true` | Enable the supervised Claude Code web-terminal service. |
+| `terminal_username` | `claude` | Username used by ttyd Basic Authentication. |
+| `terminal_password` | | Dedicated terminal password. The service idles when this and `PASSWORD` are empty. |
+| `terminal_workspace` | | Initial directory; defaults to `<data_location>/workspace`. |
+| `install_headroom` | `true` | Enable Headroom MCP for Desktop and the supervised local proxy reused by `claude-headroom`. |
+| `install_rtk` | `true` | Configure RTK's Claude Code `PreToolUse` hook. |
+| `install_caveman` | `true` | Install the Caveman Claude Code plugin in the persistent Claude home. |
 | `install_github_cli` | `true` | Enable setup checks for the baked-in `git` and `gh` commands. |
 | `github_token` | | Optional GitHub token used to authenticate `gh` and Git operations. |
 | `github_username` | | Optional global Git author name. |
 | `github_email` | | Optional global Git author email. |
-| `enable_ha_mcp` | `false` | Register Home Assistant's MCP server in Claude (requires `ha_mcp_token`). |
-| `ha_mcp_url` | `http://homeassistant:8123/api/mcp` | Streamable HTTP endpoint of Home Assistant's MCP Server integration. |
-| `ha_mcp_token` | | Home Assistant long-lived access token used by the MCP bridge. |
+| `ha_smart_context` | `true` | Enable Home Assistant smart context support for Claude tooling. |
+| `enable_ha_mcp` | `true` | Enable Home Assistant MCP support for Claude tooling. |
+| `dangerously_skip_permissions` | `false` | Reserved compatibility option; it is not applied by the terminal launcher. |
 | `additional_apps` | | Comma-separated Debian apt packages to install at startup. |
-| `additional_pip` | | Comma-separated pip packages installed at startup (via `uv`). |
-| `data_location` | `/data/data` | Persistent home directory for Claude and tooling. |
+| `additional_pip` | | Comma-separated pip packages installed with `--break-system-packages`. |
+| `data_location` | `/data/data` | Persistent home directory for both Claude clients and tooling. |
 | `env_vars` | `[]` | Additional environment variables exported inside the container. |
 
-### Permission modes
-
-```yaml
-permission_mode: auto
-```
-
-- `strict` keeps Claude Code's normal interactive permission prompts.
-- `auto` asks Claude Code's automatic permission classifier to approve safe
-  operations while retaining prompts for risky actions. This is the default.
-- `bypass` disables Claude Code permission checks by using
-  `bypassPermissions` in the shared settings and
-  `--dangerously-skip-permissions` for wrapper-launched sessions.
-
-Claude Code does not permit bypass mode when its effective UID is `0`. If the
-add-on is configured with `PUID: 0`, selecting `bypass` remaps only the shared
-`abc` runtime account to an available non-root UID (preferring `1000`, then
-`911`) before storage ownership and Desktop startup. Its configured primary
-GID is retained, so group-based access to mounted Home Assistant paths remains
-available. Strict and auto modes keep the configured identity unchanged.
-
-A root shell invoking `/usr/local/bin/claude` in bypass mode is also dropped to
-the remapped `abc` account. Directly invoking `/usr/bin/claude` as root still
-bypasses the add-on wrapper and will be rejected by Claude Code.
-
-`bypass` gives Claude broad authority over all mounted writable data and every
-command or credential available inside the add-on. Enable it only in a trusted
-installation with trusted repositories and mounts. Mounted paths must remain
-accessible to the effective non-root UID or its retained group.
-
-### TokenSave project example
-
-Only repositories listed here are indexed. Paths must be absolute, mounted in
-the add-on, and resolve to a Git working tree:
-
-```yaml
-tokensave_project_paths:
-  - /share/projects/hassio-addons
-  - /share/projects/birdnet-go
-```
-
-At startup, an uninitialized repository receives `tokensave init`; an existing
-index receives an incremental `tokensave sync`. Removing a path from the option
-stops automatic synchronization but does not delete its `.tokensave` database.
-Configured repositories are added to Git's `safe.directory` list for the shared
-runtime user before TokenSave performs repository discovery.
-
 ## Headroom behavior
 
-When `install_headroom` is enabled, the add-on registers `headroom mcp serve`
-with the explicit local proxy URL in Claude Desktop and Claude Code, then starts
-a supervised Headroom backend on `127.0.0.1:8787`.
+When `install_headroom` is enabled, the add-on registers `headroom mcp serve` in
+Claude Desktop and starts a supervised local Headroom backend. Desktop can use
+`headroom_compress`, `headroom_retrieve`, and `headroom_stats` through MCP.
 
-Claude Desktop overrides `ANTHROPIC_BASE_URL`, so Desktop chat deliberately uses
-the MCP integration. The `/usr/local/bin/claude` wrapper routes PATH-based Claude
-Code sessions through `headroom wrap claude --no-proxy`, reusing the supervised
-backend without starting a second proxy.
+Claude Desktop overrides `ANTHROPIC_BASE_URL`, so it is deliberately launched
+without proxy injection. The web terminal instead provides `claude-headroom`,
+which reuses the supervised proxy through Headroom's `--no-proxy` mode. RTK
+setup remains owned by the add-on through Headroom's `--no-rtk` mode.
 
-The dashboard is disabled externally by default. To expose it:
+The Headroom dashboard remains available at:
 
-1. Set `expose_headroom_dashboard: true`.
-2. Map `8787/tcp` in the add-on **Network** section.
-3. Open `http://<home-assistant-host>:8787/dashboard`.
-
-The dashboard is unauthenticated. Do not publish this port to the public
-internet.
-
-## Diagnostics
-
-Run the following inside the add-on through a custom script or container console:
-
-```bash
-claude-tools-doctor.sh
+```text
+http://<home-assistant-host>:8787/dashboard
 ```
 
-The report checks the tool binaries, configuration switches, configured and
-effective runtime identities, redacted MCP registrations, Claude hooks,
-permission mode, Headroom health, TokenSave indexes, routing, and recorded
-savings. It never prints MCP environment values because the Home Assistant MCP
-entry can contain a long-lived token.
-
-The hourly report can also be invoked manually:
-
-```bash
-claude-gains-report.sh
-```
-
-## Home Assistant MCP bridge
-
-To let Claude query and control Home Assistant:
-
-1. In Home Assistant, add the **Model Context Protocol Server** integration
-   (Settings → Devices & services → Add integration).
-2. Create a long-lived access token (your profile → Security).
-3. Set `enable_ha_mcp: true` and paste the token into `ha_mcp_token` in the
-   add-on configuration, then restart the add-on.
-
-The add-on bridges Claude to the integration's stateless Streamable HTTP
-endpoint (`/api/mcp`) with `mcp-proxy`. Override `ha_mcp_url` only if your Home
-Assistant instance is not reachable as `homeassistant:8123` from add-ons.
+when the `8787/tcp` port is mapped. Treat this endpoint as sensitive and do not
+expose it directly to the public internet.
 
 ## Custom scripts
 
@@ -229,14 +178,10 @@ the image.
 Persistent state is stored in the configured `data_location` (default
 `/data/data`):
 
-- Claude Desktop sign-in: `~/.config/Claude` (token encrypted via
-  gnome-keyring; keyring DB in `~/.local/share/keyrings`)
-- Claude Code settings, hooks, sessions, plugins, and permission mode:
-  `~/.claude`
-- Headroom, RTK, and TokenSave user state: their standard paths below the
-  shared home
-- TokenSave repository indexes: `.tokensave/` inside each explicitly configured
-  project
+- Claude Desktop sign-in: `~/.config/Claude`
+- Claude Code settings, hooks, sessions, and plugins: `~/.claude`
+- Default terminal workspace: `~/workspace`
+- Headroom and RTK user state: their standard paths below the shared home
 
 Volatile cache data is redirected to `/tmp/cache` through `$XDG_CACHE_HOME` and
 `$HOME/.cache`.

claude_desktop/SIGN_IN.md

@@ -4,10 +4,7 @@ Two related sign-in problems when Claude Desktop runs inside the LinuxServer Sel
 streamed desktop.
 
 **Status:**
-- **Shipped:** Problem B (keyring persistence) — the `autostart` bootstrap landed in v1.4, but
-  the `gnome-keyring` package itself was missing from the image until v1.17 (the bootstrap
-  silently no-oped and Electron logged "safeStorage encryption is not available"). Fixed in
-  v1.17: the Dockerfile now installs `gnome-keyring`.
+- **Shipped:** Problem B (keyring persistence) is implemented in v1.4 (Dockerfile + `rootfs/defaults/autostart`).
 - **Planned only:** Problem A (in-desktop browser for OAuth) is intentionally not implemented.
   The image ships no browser; complete the login with the user-side workaround below.
 
@@ -53,9 +50,8 @@ magic link into the in-session Chromium (not a phone).
 ### User-side workaround (no rebuild)
 - Add-on Configuration → `additional_apps: chromium`, restart (installed by
   `rootfs/etc/cont-init.d/80-configuration.sh`).
-- Add the two `xdg-settings`/`xdg-mime` commands to the custom script
-  `/addon_configs/db21ed7f_claude-desktop/claude_desktop.sh` (the image ships no standalone
-  terminal).
+- Run the two `xdg-settings`/`xdg-mime` commands once in an in-session terminal, or add them
+  to the custom script `/addon_configs/db21ed7f_claude-desktop/claude-desktop.sh`.
 
 ---
 
@@ -98,14 +94,14 @@ Claude Desktop uses. No extra `dbus-launch` is needed.
      then exposes the Secret Service and exports `GNOME_KEYRING_CONTROL`/`SSH_AUTH_SOCK`.
    - `--password-store=gnome-libsecret` forces Electron to use the libsecret backend instead
      of falling back to plaintext.
-3. Persistence: the keyring DB lives in `$HOME/.local/share/keyrings/` and `HOME=/data/data`
+3. Persistence: the keyring DB lives in `$HOME/.local/share/keyrings/` and `HOME=/config/data`
    (persistent add-on storage), so the empty-password login keyring survives restarts and is
    re-unlocked automatically each boot by the same `autostart` line — the sign-in then sticks.
 
 ### User-side workaround (no rebuild)
 - Add-on Configuration → `additional_apps: gnome-keyring, libsecret-1-0, dbus-x11`, restart.
 - Add the keyring-start lines above to the custom script
-  `/addon_configs/db21ed7f_claude-desktop/claude_desktop.sh`, and relaunch Claude Desktop
+  `/addon_configs/db21ed7f_claude-desktop/claude-desktop.sh`, and relaunch Claude Desktop
   with `--password-store=gnome-libsecret` (e.g. edit the in-session openbox autostart).
 
 ---

claude_desktop/config.yaml

@@ -2,7 +2,7 @@ arch:
   - aarch64
   - amd64
 audio: true
-description: "Claude Desktop with Headroom, RTK, and TokenSave optimization"
+description: Claude Desktop with a persistent Claude Code web terminal in one add-on
 devices:
   - /dev/dri
   - /dev/dri/card0
@@ -13,8 +13,8 @@ environment:
   AUTO_GPU: "1"
   FM_HOME: /data/data
   HOME: /data/data
-  PGID: "1000"
-  PUID: "1000"
+  PGID: "0"
+  PUID: "0"
   SELKIES_FRAMERATE: "30"
   START_DOCKER: "false"
   TITLE: Claude Desktop
@@ -35,33 +35,35 @@ options:
   env_vars: []
   DNS_server: 8.8.8.8
   data_location: /data/data
+  PGID: 0
+  PUID: 0
   additional_apps: ""
   additional_pip: ""
   auto_update: true
   github_email: ""
-  enable_ha_mcp: false
-  ha_mcp_url: http://homeassistant:8123/api/mcp
-  ha_mcp_token: ""
+  ha_smart_context: true
+  enable_ha_mcp: true
+  dangerously_skip_permissions: false
+  enable_terminal: true
+  terminal_username: claude
+  terminal_password: ""
+  terminal_workspace: ""
   github_token: ""
   github_username: ""
-  enable_tools_health_report: true
-  expose_headroom_dashboard: false
-  headroom_wrap_claude_code: true
-  install_caveman: false
+  install_caveman: true
   install_github_cli: true
   install_headroom: true
   install_rtk: true
-  install_tokensave: true
-  permission_mode: auto
-  tokensave_project_paths: []
 panel_admin: false
 panel_icon: mdi:robot-happy
 ports:
   3001/tcp: null
-  8787/tcp: null
+  7681/tcp: null
+  8787/tcp: 8787
 ports_description:
   3001/tcp: Claude Desktop web interface
-  8787/tcp: Optional Headroom dashboard and proxy
+  7681/tcp: HTTP Basic-auth Claude Code terminal (no TLS)
+  8787/tcp: Headroom dashboard and proxy
 privileged:
   - SYS_ADMIN
   - DAC_READ_SEARCH
@@ -74,35 +76,29 @@ schema:
   DRINODE: list(/dev/dri/card0|/dev/dri/card1|/dev/dri/card2|/dev/dri/renderD128|/dev/dri/renderD129|)?
   KEYBOARD: list(da-dk-qwerty|de-de-qwertz|en-gb-qwerty|en-us-qwerty|es-es-qwerty|fr-ch-qwertz|fr-fr-azerty|it-it-qwerty|ja-jp-qwerty|pt-br-qwerty|sv-se-qwerty|tr-tr-qwerty)?
   PASSWORD: str?
-  SUDO_PASSWORD: password?
+  PGID: int
+  PUID: int
   TZ: match([A-Z][a-z]*./[A-Z][a-z]*.)?
   additional_apps: str?
   additional_pip: str?
-  cifsdomain: str?
-  cifspassword: str?
-  cifsusername: str?
-  localdisks: str?
-  networkdisks: str?
+  auto_update: bool?
   github_email: str?
+  ha_smart_context: bool?
   enable_ha_mcp: bool?
-  ha_mcp_url: str?
-  ha_mcp_token: password?
+  dangerously_skip_permissions: bool?
+  enable_terminal: bool?
+  terminal_username: match(^[A-Za-z0-9_.-]+$)?
+  terminal_password: password?
+  terminal_workspace: str?
   github_token: password?
   github_username: str?
-  enable_tools_health_report: bool
-  expose_headroom_dashboard: bool
-  headroom_wrap_claude_code: bool
   install_caveman: bool
   install_github_cli: bool
   install_headroom: bool
   install_rtk: bool
-  install_tokensave: bool
-  permission_mode: list(strict|auto|bypass)
-  tokensave_project_paths:
-    - str
 slug: claude_desktop
 tmpfs: true
 udev: true
 url: https://github.com/alexbelgium/hassio-addons
-version: "1.23"
+version: "1.13"
 video: true

claude_desktop/rootfs/defaults/autostart

@@ -22,7 +22,8 @@ else
 fi
 
 # Headroom is intentionally not injected into the Desktop process. Claude Desktop overrides
-# ANTHROPIC_BASE_URL, so Desktop uses the registered Headroom MCP tools instead.
+# ANTHROPIC_BASE_URL, so Desktop uses the registered Headroom MCP tools instead. The Claude Code
+# terminal uses the supported `headroom wrap claude` integration through claude-headroom.
 
 # Launch the configured command. If a custom/wrapped command fails to start, fall back to
 # the plain Claude Desktop launch so the app always comes up for the user.

claude_desktop/rootfs/defaults/crontabs/root

@@ -1,4 +1,4 @@
-# Hourly RTK + Headroom + TokenSave savings report to the add-on log.
+# Hourly rtk + headroom token-savings report to the add-on log (heartbeat + gains).
 # Seeded to /data/data/crontabs/root by init-crontab-config and run by svc-cron; edit the
 # persistent copy to customize. Output goes to /proc/1/fd/1 so it shows in the add-on log.
 0 * * * * /usr/local/bin/claude-gains-report.sh > /proc/1/fd/1 2>&1

claude_desktop/rootfs/etc/cont-init.d/19-claude_bypass_runtime.sh

@@ -1,48 +0,0 @@
-#!/usr/bin/with-contenv bashio
-# shellcheck shell=bash
-set -e
-set -o pipefail
-
-# Claude Code deliberately refuses bypass-permissions mode when its effective UID is 0.
-# The add-on historically defaults PUID to 0, so switch the shared `abc` desktop user to
-# an unused non-root UID before storage ownership and Selkies runtime directories are set up.
-# Keep abc's configured primary group (commonly group 0) so existing group-based access to
-# Home Assistant mounts is preserved. Strict and auto permission modes are unchanged.
-if [ "$(bashio::config 'permission_mode')" != "bypass" ]; then
-    exit 0
-fi
-
-CURRENT_UID="$(id -u abc)"
-if [ "$CURRENT_UID" -ne 0 ]; then
-    bashio::log.info "Claude bypass runtime already uses non-root UID ${CURRENT_UID}"
-    exit 0
-fi
-
-find_available_uid() {
-    local candidate owner
-    for candidate in 1000 911 $(seq 1001 1099); do
-        owner="$(getent passwd "$candidate" | cut -d: -f1 || true)"
-        if [ -z "$owner" ] || [ "$owner" = "abc" ]; then
-            printf '%s' "$candidate"
-            return 0
-        fi
-    done
-    return 1
-}
-
-TARGET_UID="$(find_available_uid || true)"
-if [ -z "$TARGET_UID" ]; then
-    bashio::exit.nok "Claude bypass mode requires a non-root runtime user, but no free fallback UID was found"
-fi
-
-usermod --uid "$TARGET_UID" abc
-
-if [ "$(id -u abc)" -eq 0 ]; then
-    bashio::exit.nok "Unable to switch the Claude Desktop runtime away from root for bypass mode"
-fi
-
-mkdir -p /run/s6/container_environment
-printf '%s' "$TARGET_UID" > /run/s6/container_environment/CLAUDE_RUNTIME_UID
-printf '%s' "$(id -g abc)" > /run/s6/container_environment/CLAUDE_RUNTIME_GID
-
-bashio::log.warning "Claude bypass mode cannot run as root; remapped abc from UID 0 to UID ${TARGET_UID} (GID $(id -g abc))"

claude_desktop/rootfs/etc/cont-init.d/20-folders.sh

@@ -3,10 +3,9 @@
 # shellcheck disable=SC2046
 set -e
 
-# Use the effective shared desktop user identity. In bypass mode an earlier init script may
-# remap abc away from UID 0 because Claude Code rejects bypass permissions when run as root.
-PUID="$(id -u abc)"
-PGID="$(id -g abc)"
+# Define user
+PUID=$(bashio::config "PUID")
+PGID=$(bashio::config "PGID")
 
 # Check data location
 LOCATION="$(bashio::config 'data_location')"

claude_desktop/rootfs/etc/cont-init.d/80-configuration.sh

@@ -24,12 +24,7 @@ fi
 if bashio::config.has_value 'additional_pip'; then
     for p in $(bashio::config 'additional_pip' | tr ',' ' '); do
         bashio::log.green "... pip: $p"
-        # Prefer uv (much faster resolver/installer); fall back to pip3 when unavailable.
-        if command -v uv &> /dev/null; then
-            uv pip install --system --break-system-packages "$p" || bashio::log.fatal "Error: pip package $p failed"
-        else
-            pip3 install --break-system-packages "$p" || bashio::log.fatal "Error: pip package $p failed"
-        fi
+        pip3 install --break-system-packages "$p" || bashio::log.fatal "Error: pip package $p failed"
     done
 fi
 

claude_desktop/rootfs/etc/cont-init.d/81-claude_update.sh

@@ -2,9 +2,11 @@
 # shellcheck shell=bash
 set -e
 
-bashio::log.info "Checking for Claude Desktop updates..."
-if apt-get update -o Acquire::http::Timeout=10 -o Acquire::https::Timeout=10 &> /dev/null && apt-get install -y --only-upgrade claude-desktop &> /dev/null; then
-    bashio::log.info "Claude Desktop version: $(dpkg-query -W -f='${Version}' claude-desktop)"
-else
-    bashio::log.warning "Update check failed (offline?), keeping current version"
+if bashio::config.true 'auto_update'; then
+    bashio::log.info "Checking for Claude Desktop updates..."
+    if apt-get update -o Acquire::http::Timeout=10 -o Acquire::https::Timeout=10 &> /dev/null && apt-get install -y --only-upgrade claude-desktop &> /dev/null; then
+        bashio::log.info "Claude Desktop version: $(dpkg-query -W -f='${Version}' claude-desktop)"
+    else
+        bashio::log.warning "Update check failed (offline?), keeping current version"
+    fi
 fi

claude_desktop/rootfs/etc/cont-init.d/81-tokensave_repositories.sh

@@ -1,36 +0,0 @@
-#!/usr/bin/with-contenv bashio
-# shellcheck shell=bash
-set -e
-set -o pipefail
-
-if ! bashio::config.true 'install_tokensave' || ! command -v git > /dev/null 2>&1; then
-    exit 0
-fi
-
-declare -A REPOS_SEEN=()
-while IFS= read -r configured_path; do
-    configured_path="${configured_path#"${configured_path%%[![:space:]]*}"}"
-    configured_path="${configured_path%"${configured_path##*[![:space:]]}"}"
-    [ -n "$configured_path" ] || continue
-
-    case "$configured_path" in
-        /*) ;;
-        *) continue ;;
-    esac
-    [ -d "$configured_path" ] || continue
-
-    # The one-shot safe.directory override is used only to discover the repository root.
-    # Persist the resolved root in the shared runtime user's Git config before 82-claude_tools.sh
-    # performs normal repository detection, avoiding Git's dubious-ownership rejection.
-    repo_root="$(s6-setuidgid abc env HOME="$HOME" \
-        git -c safe.directory='*' -C "$configured_path" rev-parse --show-toplevel 2> /dev/null || true)"
-    [ -n "$repo_root" ] && [ "$repo_root" != "/" ] || continue
-    [[ -z "${REPOS_SEEN[$repo_root]:-}" ]] || continue
-    REPOS_SEEN[$repo_root]=1
-
-    if ! s6-setuidgid abc env HOME="$HOME" git config --global --get-all safe.directory \
-        | grep -Fxq -- "$repo_root"; then
-        s6-setuidgid abc env HOME="$HOME" git config --global --add safe.directory "$repo_root"
-        bashio::log.info "Marked TokenSave repository as safe for Git: ${repo_root}"
-    fi
-done < <(bashio::config.array 'tokensave_project_paths')

claude_desktop/rootfs/etc/cont-init.d/82-claude_tools.sh

@@ -7,210 +7,69 @@ PUID="$(if bashio::config.has_value 'PUID'; then bashio::config 'PUID'; else ech
 PGID="$(if bashio::config.has_value 'PGID'; then bashio::config 'PGID'; else echo '0'; fi)"
 mkdir -p "$HOME/.claude"
 
-run_as_runtime_user() {
-    s6-setuidgid abc env HOME="$HOME" "$@"
-}
-
 CLAUDE_DESKTOP_COMMAND_FILE="/tmp/claude-desktop-command"
 DEFAULT_CLAUDE_DESKTOP_COMMAND='claude-desktop --no-sandbox --disable-dev-shm-usage --password-store=gnome-libsecret'
 printf '%s\n' "$DEFAULT_CLAUDE_DESKTOP_COMMAND" > "$CLAUDE_DESKTOP_COMMAND_FILE"
 
-# Headroom's proxy routing works by setting ANTHROPIC_BASE_URL, which the Claude Desktop
-# Electron app force-overrides to the production endpoint (headroom #869). Desktop therefore
-# uses Headroom's MCP tools. Claude Code launches that resolve `claude` through PATH use the
-# add-on's /usr/local/bin/claude wrapper and can be transparently proxied when enabled.
-#
-# Register the add-on-managed MCP servers (headroom, tokensave, homeassistant) in both Claude
-# Desktop's config and Claude Code's user config (used by Desktop cowork/dispatch sessions).
-# The merge is idempotent, preserves any other MCP servers, never overwrites a user-customized
-# entry with a different command, and removes only add-on-managed entries when disabled.
+# headroom's "wrap"/proxy routing works by setting ANTHROPIC_BASE_URL, which the Claude Desktop
+# Electron app force-overrides to the production endpoint (headroom #869), so transparent
+# compression cannot be applied to the desktop launch. The integration that does work with
+# Claude Desktop is headroom's MCP server, which exposes the headroom_compress/headroom_retrieve/
+# headroom_stats tools inside the app. Register it in Claude Desktop's MCP config, leaving the
+# plain launch untouched. The merge is idempotent and preserves any other MCP servers.
 CLAUDE_DESKTOP_CONFIG="$HOME/.config/Claude/claude_desktop_config.json"
-CLAUDE_CODE_CONFIG="$HOME/.claude.json"
-
-HEADROOM_ENABLED=false
 if bashio::config.true 'install_headroom'; then
     if command -v headroom &> /dev/null; then
-        HEADROOM_ENABLED=true
-        bashio::log.info "headroom $(headroom --version 2> /dev/null || true) available; registering the headroom MCP server"
-    else
-        bashio::log.warning "headroom is not available"
-    fi
-fi
-
-TOKENSAVE_ENABLED=false
-if bashio::config.true 'install_tokensave'; then
-    if command -v tokensave &> /dev/null; then
-        TOKENSAVE_ENABLED=true
-        bashio::log.info "tokensave $(tokensave --version 2> /dev/null || true) available; configuring the complete Claude Code integration"
-        # The upstream installer adds the MCP entry, PreToolUse/UserPromptSubmit/Stop hooks,
-        # MCP permissions, global CLAUDE.md rules, and the global post-commit/checkout sync hook.
-        run_as_runtime_user tokensave install --agent claude --git-hook yes \
-            || bashio::log.warning "tokensave Claude Code integration setup failed"
-    else
-        bashio::log.warning "tokensave is not available"
-    fi
-elif command -v tokensave &> /dev/null; then
-    bashio::log.info "Removing the tokensave Claude Code integration"
-    run_as_runtime_user tokensave uninstall --agent claude \
-        || bashio::log.warning "tokensave Claude Code integration removal failed"
-fi
-
-HA_MCP_ENABLED=false
-HA_MCP_URL=""
-HA_MCP_TOKEN=""
-if bashio::config.true 'enable_ha_mcp'; then
-    HA_MCP_URL="$(bashio::config 'ha_mcp_url' 'http://homeassistant:8123/api/mcp')"
-    if bashio::config.has_value 'ha_mcp_token'; then
-        HA_MCP_TOKEN="$(bashio::config 'ha_mcp_token')"
-    fi
-    if [ -z "$HA_MCP_TOKEN" ]; then
-        bashio::log.warning "enable_ha_mcp is on but ha_mcp_token is empty; set a Home Assistant long-lived access token (Profile -> Security) and enable the 'Model Context Protocol Server' integration"
-    elif ! command -v mcp-proxy &> /dev/null; then
-        bashio::log.warning "mcp-proxy is not available; cannot register the Home Assistant MCP server"
-    else
-        HA_MCP_ENABLED=true
-        bashio::log.info "Registering the Home Assistant MCP server (${HA_MCP_URL})"
-    fi
-fi
-
-HEADROOM_ENABLED="$HEADROOM_ENABLED" HEADROOM_BIN="$(command -v headroom || echo headroom)" \
-    TOKENSAVE_ENABLED="$TOKENSAVE_ENABLED" TOKENSAVE_BIN="$(command -v tokensave || echo tokensave)" \
-    HA_MCP_ENABLED="$HA_MCP_ENABLED" HA_MCP_URL="$HA_MCP_URL" HA_MCP_TOKEN="$HA_MCP_TOKEN" \
-    MCP_PROXY_BIN="$(command -v mcp-proxy || echo mcp-proxy)" \
-    CLAUDE_DESKTOP_CONFIG="$CLAUDE_DESKTOP_CONFIG" CLAUDE_CODE_CONFIG="$CLAUDE_CODE_CONFIG" \
-    python3 - <<'PY' || bashio::log.warning "Unable to update the MCP server registrations automatically"
+        bashio::log.info "headroom $(headroom --version 2> /dev/null || true) available; registering the headroom MCP server for Claude Desktop"
+        HEADROOM_BIN="$(command -v headroom)" CLAUDE_DESKTOP_CONFIG="$CLAUDE_DESKTOP_CONFIG" python3 - <<'PY' || bashio::log.warning "Unable to register the headroom MCP server automatically"
 import json
 import os
 from pathlib import Path
 
-MANAGED_BASENAMES = {
-    "headroom": "headroom",
-    "tokensave": "tokensave",
-    "homeassistant": "mcp-proxy",
-}
-
-desired = {}
-if os.environ["HEADROOM_ENABLED"] == "true":
-    desired["headroom"] = {
-        "command": os.environ["HEADROOM_BIN"],
-        "args": ["mcp", "serve", "--proxy-url", "http://127.0.0.1:8787"],
-    }
-if os.environ["TOKENSAVE_ENABLED"] == "true":
-    desired["tokensave"] = {"command": os.environ["TOKENSAVE_BIN"], "args": ["serve"]}
-if os.environ["HA_MCP_ENABLED"] == "true":
-    # Home Assistant's MCP Server integration speaks stateless Streamable HTTP on /api/mcp;
-    # mcp-proxy defaults to SSE, so the transport flags are required.
-    desired["homeassistant"] = {
-        "command": os.environ["MCP_PROXY_BIN"],
-        "args": ["--transport=streamablehttp", "--stateless", os.environ["HA_MCP_URL"]],
-        "env": {"API_ACCESS_TOKEN": os.environ["HA_MCP_TOKEN"]},
-    }
-
-# An entry is add-on-managed when its command is one of our binaries living outside the
-# persistent home. Matching on the basename (rather than the exact path recorded at write
-# time) keeps entries updatable when a base-image upgrade moves the binary, while commands
-# under $HOME stay untouched because those are user-installed.
-HOME_PREFIX = os.path.expanduser("~") + os.sep
-
-
-def is_managed(name, entry):
-    if not isinstance(entry, dict):
-        return False
-    command = entry.get("command")
-    if not isinstance(command, str) or command.startswith(HOME_PREFIX):
-        return False
-    return os.path.basename(command) == MANAGED_BASENAMES[name]
-
-
-for config_var, stdio_type in (("CLAUDE_DESKTOP_CONFIG", False), ("CLAUDE_CODE_CONFIG", True)):
-    path = Path(os.environ[config_var])
-    try:
-        data = json.loads(path.read_text()) if path.exists() else {}
-        if not isinstance(data, dict):
-            data = {}
-    except Exception:
-        if path.exists():
-            path.rename(path.with_suffix(path.suffix + ".bak"))
+path = Path(os.environ["CLAUDE_DESKTOP_CONFIG"])
+try:
+    data = json.loads(path.read_text()) if path.exists() else {}
+    if not isinstance(data, dict):
         data = {}
-    servers = data.get("mcpServers")
-    if not isinstance(servers, dict):
-        servers = {}
-    changed = False
-    for name in MANAGED_BASENAMES:
-        existing = servers.get(name)
-        if name in desired:
-            entry = dict(desired[name])
-            if stdio_type:
-                entry["type"] = "stdio"
-            if existing is None or is_managed(name, existing):
-                if existing != entry:
-                    servers[name] = entry
-                    changed = True
-        elif existing is not None and is_managed(name, existing):
-            del servers[name]
-            changed = True
-    if not changed:
-        continue
-    if servers:
-        data["mcpServers"] = servers
-    else:
-        data.pop("mcpServers", None)
-    path.parent.mkdir(parents=True, exist_ok=True)
-    path.write_text(json.dumps(data, indent=2) + "\n")
-    # The Home Assistant long-lived access token is stored here in clear text.
-    path.chmod(0o600)
+except Exception:
+    if path.exists():
+        path.rename(path.with_suffix(path.suffix + ".bak"))
+    data = {}
+servers = data.get("mcpServers")
+if not isinstance(servers, dict):
+    servers = {}
+    data["mcpServers"] = servers
+servers["headroom"] = {"command": os.environ.get("HEADROOM_BIN", "headroom"), "args": ["mcp", "serve"]}
+path.parent.mkdir(parents=True, exist_ok=True)
+path.write_text(json.dumps(data, indent=2) + "\n")
 PY
+    else
+        bashio::log.warning "headroom is not available"
+    fi
+elif [ -f "$CLAUDE_DESKTOP_CONFIG" ]; then
+    bashio::log.info "Removing the headroom MCP server from Claude Desktop"
+    CLAUDE_DESKTOP_CONFIG="$CLAUDE_DESKTOP_CONFIG" python3 - <<'PY' || bashio::log.warning "Unable to remove the headroom MCP server automatically"
+import json
+import os
+from pathlib import Path
 
-# Initialize or incrementally sync only explicitly configured repositories. TokenSave deliberately
-# requires one-time per-project opt-in; an empty list therefore has no startup or storage cost.
-if $TOKENSAVE_ENABLED; then
-    declare -A TOKENSAVE_REPOS_SEEN=()
-    while IFS= read -r configured_path; do
-        # Trim surrounding whitespace while preserving spaces inside paths.
-        configured_path="${configured_path#"${configured_path%%[![:space:]]*}"}"
-        configured_path="${configured_path%"${configured_path##*[![:space:]]}"}"
-        [ -n "$configured_path" ] || continue
-
-        case "$configured_path" in
-            /*) ;;
-            *)
-                bashio::log.warning "Skipping non-absolute tokensave_project_paths entry: ${configured_path}"
-                continue
-                ;;
-        esac
-        if [ ! -d "$configured_path" ]; then
-            bashio::log.warning "Skipping missing TokenSave project path: ${configured_path}"
-            continue
-        fi
-
-        repo_root="$(git -C "$configured_path" rev-parse --show-toplevel 2> /dev/null || true)"
-        if [ -z "$repo_root" ] || [ "$repo_root" = "/" ]; then
-            bashio::log.warning "Skipping TokenSave path that is not a supported Git repository: ${configured_path}"
-            continue
-        fi
-        if [[ -n "${TOKENSAVE_REPOS_SEEN[$repo_root]:-}" ]]; then
-            continue
-        fi
-        TOKENSAVE_REPOS_SEEN[$repo_root]=1
-
-        if [ -f "$repo_root/.tokensave/tokensave.db" ]; then
-            bashio::log.info "Synchronizing TokenSave index: ${repo_root}"
-            run_as_runtime_user tokensave sync "$repo_root" \
-                || bashio::log.warning "TokenSave sync failed for ${repo_root}"
-        else
-            bashio::log.info "Initializing TokenSave index: ${repo_root}"
-            run_as_runtime_user tokensave init "$repo_root" \
-                || bashio::log.warning "TokenSave initialization failed for ${repo_root}"
-        fi
-    done < <(bashio::config.array 'tokensave_project_paths')
+path = Path(os.environ["CLAUDE_DESKTOP_CONFIG"])
+data = json.loads(path.read_text())
+if isinstance(data, dict):
+    servers = data.get("mcpServers")
+    if isinstance(servers, dict) and servers.pop("headroom", None) is not None:
+        if not servers:
+            data.pop("mcpServers", None)
+        path.write_text(json.dumps(data, indent=2) + "\n")
+PY
 fi
 
-# Guide Claude to actually use the Headroom compression tools so the MCP integration produces
-# real savings when transparent proxying is unavailable. Managed, idempotent block appended to
-# the user's global CLAUDE.md; removed when Headroom is disabled.
+# Guide Claude to actually use the headroom compression tools so the MCP integration produces
+# real savings (otherwise the tools sit unused and `headroom savings` stays empty). Managed,
+# idempotent block appended to the user's global CLAUDE.md; removed when headroom is disabled.
 CLAUDE_MD="$HOME/.claude/CLAUDE.md"
 HEADROOM_GUIDE_BEGIN="<!-- BEGIN headroom (managed by claude_desktop addon) -->"
-if $HEADROOM_ENABLED; then
+if bashio::config.true 'install_headroom'; then
     mkdir -p "$(dirname "$CLAUDE_MD")"
     if ! { [ -f "$CLAUDE_MD" ] && grep -qF "$HEADROOM_GUIDE_BEGIN" "$CLAUDE_MD"; }; then
         bashio::log.info "Adding headroom usage guidance to CLAUDE.md"
@@ -253,13 +112,14 @@ fi
 
 if bashio::config.true 'install_rtk'; then
     if command -v rtk &> /dev/null; then
-        bashio::log.info "Configuring rtk Claude Code integration"
-        run_as_runtime_user env RTK_NONINTERACTIVE=1 rtk init -g \
-            || bashio::log.warning "rtk global files configuration failed"
-        python3 - <<'PY' || bashio::log.warning "Unable to configure rtk hook automatically"
+        if [ -f "$HOME/.claude/settings.json" ] && grep -q 'rtk hook claude' "$HOME/.claude/settings.json"; then
+            bashio::log.info "rtk Claude Code hook already configured"
+        else
+            bashio::log.info "Configuring rtk Claude Code hook"
+            RTK_NONINTERACTIVE=1 rtk init -g || bashio::log.warning "rtk global files configuration failed"
+            python3 - <<'PY' || bashio::log.warning "Unable to configure rtk hook automatically"
 import json
 from pathlib import Path
-
 path = Path.home() / ".claude" / "settings.json"
 try:
     data = json.loads(path.read_text()) if path.exists() else {}
@@ -277,6 +137,7 @@ if not any("rtk hook claude" in json.dumps(entry) for entry in pre if isinstance
 path.parent.mkdir(parents=True, exist_ok=True)
 path.write_text(json.dumps(data, indent=2) + "\n")
 PY
+        fi
     else
         bashio::log.warning "rtk is not available"
     fi
@@ -348,17 +209,16 @@ if bashio::config.true 'install_caveman'; then
         bashio::log.info "caveman Claude Code plugin already configured"
     else
         bashio::log.info "Installing caveman Claude Code plugin"
-        curl --connect-timeout 10 --max-time 60 -fsSL https://raw.githubusercontent.com/JuliusBrussee/caveman/main/install.sh | bash > /dev/null \
-            || bashio::log.warning "caveman install failed (offline?)"
+        curl --connect-timeout 10 --max-time 60 -fsSL https://raw.githubusercontent.com/JuliusBrussee/caveman/main/install.sh | bash >/dev/null || bashio::log.warning "caveman install failed (offline?)"
     fi
 else
     bashio::log.info "Disabling caveman Claude Code plugin"
     find "$HOME/.claude" -maxdepth 4 -iname '*caveman*' -exec rm -rf {} + 2> /dev/null || true
 fi
 
-# Startup configuration runs as root, while Claude Desktop runs as abc. Return managed
-# persistent files to the configured runtime UID/GID after all writes complete.
-for managed_path in "$HOME/.claude" "$HOME/.claude.json" "$HOME/.config/Claude"; do
+# Startup configuration runs as root, while Claude Desktop and the web terminal run as abc.
+# Return managed persistent files to the configured runtime UID/GID after all writes complete.
+for managed_path in "$HOME/.claude" "$HOME/.config/Claude"; do
     if [ -e "$managed_path" ]; then
         chown -R -- "${PUID}:${PGID}" "$managed_path" || bashio::log.warning "Unable to set ownership on $managed_path"
     fi

claude_desktop/rootfs/etc/cont-init.d/83-claude_permissions.sh

@@ -1,92 +0,0 @@
-#!/usr/bin/with-contenv bashio
-# shellcheck shell=bash
-set -e
-set -o pipefail
-
-PUID="$(if bashio::config.has_value 'PUID'; then bashio::config 'PUID'; else echo '0'; fi)"
-PGID="$(if bashio::config.has_value 'PGID'; then bashio::config 'PGID'; else echo '0'; fi)"
-PERMISSION_MODE="$(bashio::config 'permission_mode')"
-SETTINGS_PATH="$HOME/.claude/settings.json"
-STATE_PATH="$HOME/.claude/.addon-permission-mode.json"
-
-case "$PERMISSION_MODE" in
-    strict|auto|bypass) ;;
-    *)
-        bashio::log.warning "Unknown permission_mode '${PERMISSION_MODE}'; falling back to strict"
-        PERMISSION_MODE="strict"
-        ;;
-esac
-
-mkdir -p "$(dirname "$SETTINGS_PATH")"
-PERMISSION_MODE="$PERMISSION_MODE" SETTINGS_PATH="$SETTINGS_PATH" STATE_PATH="$STATE_PATH" python3 - <<'PY'
-import json
-import os
-from pathlib import Path
-
-mode = os.environ["PERMISSION_MODE"]
-settings_path = Path(os.environ["SETTINGS_PATH"])
-state_path = Path(os.environ["STATE_PATH"])
-
-try:
-    settings = json.loads(settings_path.read_text()) if settings_path.exists() else {}
-except (OSError, json.JSONDecodeError):
-    if settings_path.exists():
-        settings_path.rename(settings_path.with_suffix(settings_path.suffix + ".bak"))
-    settings = {}
-if not isinstance(settings, dict):
-    settings = {}
-
-try:
-    state = json.loads(state_path.read_text()) if state_path.exists() else None
-except (OSError, json.JSONDecodeError):
-    state = None
-if not isinstance(state, dict):
-    state = None
-
-permissions = settings.get("permissions")
-if not isinstance(permissions, dict):
-    permissions = {}
-
-if mode == "strict":
-    # Restore the value that existed before the add-on first managed this setting.
-    if state is not None:
-        if state.get("previous_exists"):
-            permissions["defaultMode"] = state.get("previous_value")
-        else:
-            permissions.pop("defaultMode", None)
-        state_path.unlink(missing_ok=True)
-else:
-    if state is None:
-        state = {
-            "previous_exists": "defaultMode" in permissions,
-            "previous_value": permissions.get("defaultMode"),
-        }
-        state_path.write_text(json.dumps(state, indent=2) + "\n")
-        state_path.chmod(0o600)
-    permissions["defaultMode"] = "auto" if mode == "auto" else "bypassPermissions"
-
-if permissions:
-    settings["permissions"] = permissions
-else:
-    settings.pop("permissions", None)
-
-settings_path.write_text(json.dumps(settings, indent=2) + "\n")
-settings_path.chmod(0o600)
-PY
-
-case "$PERMISSION_MODE" in
-    strict)
-        bashio::log.info "Claude Code permission mode: strict (normal prompts)"
-        ;;
-    auto)
-        bashio::log.info "Claude Code permission mode: auto (safe actions approved automatically)"
-        ;;
-    bypass)
-        bashio::log.warning "Claude Code permission mode: bypass (permission checks disabled for mounted data and available tools)"
-        ;;
-esac
-
-chown -- "${PUID}:${PGID}" "$SETTINGS_PATH" 2> /dev/null || true
-if [ -e "$STATE_PATH" ]; then
-    chown -- "${PUID}:${PGID}" "$STATE_PATH" 2> /dev/null || true
-fi

claude_desktop/rootfs/etc/cont-init.d/84-claude_runtime_ownership.sh

@@ -1,17 +0,0 @@
-#!/usr/bin/with-contenv bashio
-# shellcheck shell=bash
-set -e
-
-# Earlier configuration scripts intentionally run as root and may use the configured PUID/PGID
-# values when returning files to the runtime user. In bypass mode PUID can still be configured as
-# 0 even though 19-claude_bypass_runtime.sh remapped abc to a non-root UID. Reconcile ownership
-# with the effective desktop identity after all Claude configuration writes are complete.
-RUNTIME_UID="$(id -u abc)"
-RUNTIME_GID="$(id -g abc)"
-
-for managed_path in "$HOME/.claude" "$HOME/.claude.json" "$HOME/.config/Claude"; do
-    if [ -e "$managed_path" ]; then
-        chown -R -- "${RUNTIME_UID}:${RUNTIME_GID}" "$managed_path" \
-            || bashio::log.warning "Unable to set effective runtime ownership on $managed_path"
-    fi
-done

claude_desktop/rootfs/etc/s6-overlay/s6-rc.d/svc-claude-terminal/run

@@ -0,0 +1,101 @@
+#!/usr/bin/with-contenv bashio
+# shellcheck shell=bash
+set -e
+set -o pipefail
+
+declare port=7681
+declare username
+declare password=""
+declare workspace
+declare canonical_workspace
+
+export PATH="${HOME:-/data/data}/.local/bin:/usr/local/bin:/usr/bin:/bin:${PATH:-}"
+
+if bashio::config.has_value 'enable_terminal' && ! bashio::config.true 'enable_terminal'; then
+    bashio::log.info "svc-claude-terminal: terminal disabled; idling"
+    exec sleep infinity
+fi
+
+if [ -z "${HOME:-}" ]; then
+    bashio::log.error "svc-claude-terminal: HOME is not initialized; idling"
+    exec sleep infinity
+fi
+
+if ! command -v ttyd >/dev/null 2>&1 || ! command -v tmux >/dev/null 2>&1 || ! command -v claude >/dev/null 2>&1; then
+    bashio::log.error "svc-claude-terminal: ttyd, tmux, or Claude Code is missing; idling"
+    exec sleep infinity
+fi
+
+username="claude"
+if bashio::config.has_value 'terminal_username'; then
+    username="$(bashio::config 'terminal_username')"
+fi
+
+if bashio::config.has_value 'terminal_password'; then
+    password="$(bashio::config 'terminal_password')"
+elif bashio::config.has_value 'PASSWORD'; then
+    bashio::log.warning "svc-claude-terminal: using PASSWORD as fallback for terminal authentication; prefer a unique terminal_password"
+    password="$(bashio::config 'PASSWORD')"
+fi
+
+if [ -z "$password" ]; then
+    bashio::log.warning "svc-claude-terminal: set terminal_password (or PASSWORD) before mapping port ${port}; terminal will remain disabled"
+    exec sleep infinity
+fi
+
+workspace="${HOME}/workspace"
+if bashio::config.has_value 'terminal_workspace'; then
+    workspace="$(bashio::config 'terminal_workspace')"
+fi
+
+if [[ "$workspace" != /* ]]; then
+    bashio::log.error "svc-claude-terminal: terminal_workspace must be an absolute path; idling"
+    exec sleep infinity
+fi
+
+if [ -L "$workspace" ]; then
+    bashio::log.error "svc-claude-terminal: terminal_workspace must not be a symbolic link; idling"
+    exec sleep infinity
+fi
+
+if ! canonical_workspace="$(realpath -m -- "$workspace")"; then
+    bashio::log.error "svc-claude-terminal: unable to resolve terminal_workspace '$workspace'; idling"
+    exec sleep infinity
+fi
+workspace="$canonical_workspace"
+
+case "$workspace" in
+    "$HOME" | "$HOME"/* | /share/* | /media/* | /mnt/* | /data/* | /config/*)
+        ;;
+    *)
+        bashio::log.error "svc-claude-terminal: terminal_workspace must be the configured data_location or a subdirectory of /share, /media, /mnt, /data, or /config; idling"
+        exec sleep infinity
+        ;;
+esac
+
+if [ ! -e "$workspace" ]; then
+    if ! install -d -m 0750 -o abc -g abc -- "$workspace"; then
+        bashio::log.error "svc-claude-terminal: failed to create workspace '$workspace'; idling"
+        exec sleep infinity
+    fi
+elif [ ! -d "$workspace" ]; then
+    bashio::log.error "svc-claude-terminal: terminal_workspace '$workspace' is not a directory; idling"
+    exec sleep infinity
+fi
+
+if ! s6-setuidgid abc test -r "$workspace" ||
+    ! s6-setuidgid abc test -w "$workspace" ||
+    ! s6-setuidgid abc test -x "$workspace"; then
+    bashio::log.error "svc-claude-terminal: workspace '$workspace' must be readable, writable, and searchable by user abc; idling"
+    exec sleep infinity
+fi
+
+export CLAUDE_TERMINAL_WORKSPACE="$workspace"
+
+bashio::log.info "svc-claude-terminal: starting authenticated ttyd terminal on port ${port}; workspace=${workspace}"
+exec s6-setuidgid abc ttyd \
+    -p "$port" \
+    -W \
+    -O \
+    -c "${username}:${password}" \
+    /usr/local/bin/claude-terminal-shell

claude_desktop/rootfs/etc/s6-overlay/s6-rc.d/svc-claude-terminal/type

@@ -0,0 +1 @@
+longrun

claude_desktop/rootfs/etc/s6-overlay/s6-rc.d/svc-headroom/run

@@ -3,13 +3,7 @@
 declare port=8787
 declare host=127.0.0.1
 
-# The dashboard is unauthenticated. Keep it container-local by default and bind all
-# interfaces only when the user explicitly opts in and maps port 8787.
-if bashio::config.true 'expose_headroom_dashboard'; then
-    host=0.0.0.0
-fi
-
-if bashio::config.true 'install_headroom' && command -v headroom > /dev/null 2>&1; then
+if bashio::config.true 'install_headroom' && command -v headroom >/dev/null 2>&1; then
     bashio::log.info "svc-headroom: starting local Headroom proxy on ${host}:${port}"
     exec s6-setuidgid abc headroom proxy --host "${host}" --port "${port}" --code-aware
 fi

claude_desktop/rootfs/usr/local/bin/claude

@@ -1,53 +0,0 @@
-#!/usr/bin/with-contenv bashio
-# shellcheck shell=bash
-set -o pipefail
-
-REAL_CLAUDE="/usr/bin/claude"
-HEADROOM_BIN="/usr/local/bin/headroom"
-HEADROOM_URL="http://127.0.0.1:8787"
-PERMISSION_MODE="$(bashio::config 'permission_mode')"
-declare -a CLAUDE_PERMISSION_ARGS=()
-
-case "$PERMISSION_MODE" in
-    bypass)
-        CLAUDE_PERMISSION_ARGS+=("--dangerously-skip-permissions")
-        ;;
-    auto)
-        CLAUDE_PERMISSION_ARGS+=("--permission-mode" "auto")
-        ;;
-    strict|"")
-        ;;
-    *)
-        echo "claude wrapper: unknown permission_mode '${PERMISSION_MODE}', using strict mode" >&2
-        ;;
-esac
-
-if [ ! -x "$REAL_CLAUDE" ]; then
-    echo "claude wrapper: ${REAL_CLAUDE} is unavailable" >&2
-    exit 127
-fi
-
-# Claude Code rejects bypass mode when the effective UID is 0. Normal Desktop sessions run
-# as abc, which startup remaps to a non-root UID when bypass is selected. Also handle a user
-# invoking this wrapper directly from a root container console by dropping to abc here.
-if [ "$PERMISSION_MODE" = "bypass" ] && [ "$(id -u)" -eq 0 ]; then
-    if command -v s6-setuidgid > /dev/null 2>&1 && [ "$(id -u abc)" -ne 0 ]; then
-        exec s6-setuidgid abc "$0" "$@"
-    fi
-    echo "claude wrapper: bypass mode requires a non-root runtime user, but abc is still UID 0" >&2
-    exit 1
-fi
-
-if bashio::config.true 'install_headroom' && bashio::config.true 'headroom_wrap_claude_code'; then
-    if [ -x "$HEADROOM_BIN" ] && curl -fsS --max-time 2 "${HEADROOM_URL}/health" > /dev/null 2>&1; then
-        # Put /usr/bin before /usr/local/bin while Headroom resolves its upstream `claude`
-        # executable; otherwise it would resolve this wrapper recursively.
-        export HEADROOM_CONTEXT_TOOL="rtk"
-        exec env PATH="/usr/bin:/bin:/usr/local/bin" \
-            "$HEADROOM_BIN" wrap claude --no-proxy -- \
-            "${CLAUDE_PERMISSION_ARGS[@]}" "$@"
-    fi
-    echo "claude wrapper: Headroom proxy is unavailable; launching Claude Code directly" >&2
-fi
-
-exec "$REAL_CLAUDE" "${CLAUDE_PERMISSION_ARGS[@]}" "$@"

claude_desktop/rootfs/usr/local/bin/claude-direct

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+exec claude "$@"

claude_desktop/rootfs/usr/local/bin/claude-gains-report.sh

@@ -1,44 +1,34 @@
 #!/usr/bin/with-contenv bashio
-# Hourly RTK + Headroom + TokenSave token-savings snapshot for the add-on log.
-# Invoked by cron (see /defaults/crontabs/root); stdout is redirected to /proc/1/fd/1.
-# Each tool is reported independently so enabling Headroom cannot hide RTK or TokenSave data.
-# with-contenv supplies the configured persistent HOME.
-export NO_COLOR=1
+# Hourly rtk + headroom token-savings snapshot for the add-on log.
+# Invoked by cron (see /defaults/crontabs/root); its stdout is redirected to /proc/1/fd/1,
+# so the report appears in the add-on log. Doubles as a heartbeat: if the numbers stop
+# growing, the corresponding tool has stopped working.
+# with-contenv supplies HOME from the s6 envdir, so this honors a custom `data_location`
+# (see 20-folders.sh) instead of hardcoding /data/data; it also makes bashio::config
+# available for the install_headroom gate below.
+export NO_COLOR=1                                   # keep the add-on log free of ANSI color codes
 export PATH="/lsiopy/bin:/usr/local/bin:/usr/bin:/bin:${PATH}"
 
-if ! bashio::config.true 'enable_tools_health_report'; then
-    exit 0
-fi
+have_rtk=false;      command -v rtk >/dev/null 2>&1      && have_rtk=true
+have_headroom=false; command -v headroom >/dev/null 2>&1 && have_headroom=true
 
-rtk_enabled=false
+# headroom is pip-installed unconditionally at build time, so its binary is on PATH even
+# when install_headroom is off — gate on the same config svc-headroom checks, and only
+# fall back to have_headroom as a secondary availability guard.
 headroom_enabled=false
-tokensave_enabled=false
-
-if bashio::config.true 'install_rtk' && command -v rtk > /dev/null 2>&1; then
-    rtk_enabled=true
-fi
-if bashio::config.true 'install_headroom' && command -v headroom > /dev/null 2>&1; then
+if bashio::config.true 'install_headroom' && $have_headroom; then
     headroom_enabled=true
 fi
-if bashio::config.true 'install_tokensave' && command -v tokensave > /dev/null 2>&1; then
-    tokensave_enabled=true
-fi
 
-if ! $rtk_enabled && ! $headroom_enabled && ! $tokensave_enabled; then
-    exit 0
-fi
+# Nothing to report if neither tool is active — stay quiet.
+if ! $have_rtk && ! $headroom_enabled; then exit 0; fi
 
-echo "===== claude tools report $(date '+%Y-%m-%d %H:%M:%S') ====="
+echo "===== claude gains report $(date '+%Y-%m-%d %H:%M:%S') ====="
 if $headroom_enabled; then
     echo "--- headroom savings ---"
     headroom savings 2>&1 || echo "[warn] headroom savings failed"
-fi
-if $rtk_enabled; then
+elif $have_rtk; then
     echo "--- rtk gain ---"
     rtk gain 2>&1 || echo "[warn] rtk gain failed"
 fi
-if $tokensave_enabled; then
-    echo "--- tokensave gain ---"
-    tokensave gain --all --range 30d 2>&1 || echo "[warn] tokensave gain failed"
-fi
-echo "===== end claude tools report ====="
+echo "===== end gains report ====="

claude_desktop/rootfs/usr/local/bin/claude-headroom

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if ! command -v claude >/dev/null 2>&1; then
+    echo "Claude Code is not installed or is not on PATH." >&2
+    exit 127
+fi
+
+if ! command -v headroom >/dev/null 2>&1; then
+    echo "Headroom is unavailable; start Claude Code directly with claude-direct." >&2
+    exit 127
+fi
+
+if ! curl -fsS --max-time 3 "http://127.0.0.1:8787/readyz" >/dev/null; then
+    echo "The supervised Headroom proxy is not ready on 127.0.0.1:8787. Ensure install_headroom is enabled and check the add-on log." >&2
+    exit 1
+fi
+
+# Reuse the s6-supervised proxy instead of starting a competing proxy. RTK is already managed
+# through the persistent Claude Code PreToolUse hook, so Headroom must not reinstall it.
+exec headroom wrap claude --port 8787 --no-proxy --no-rtk -- "$@"

claude_desktop/rootfs/usr/local/bin/claude-terminal-shell

@@ -0,0 +1,24 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [ -z "${HOME:-}" ]; then
+    echo "Claude terminal: HOME is not initialized." >&2
+    exit 1
+fi
+
+export SHELL="/bin/bash"
+export PATH="${HOME}/.local/bin:/usr/local/bin:/usr/bin:/bin:${PATH:-}"
+
+workspace="${CLAUDE_TERMINAL_WORKSPACE:-${HOME}/workspace}"
+session_name="${CLAUDE_TMUX_SESSION:-claude}"
+
+if [ ! -d "$workspace" ]; then
+    echo "Claude terminal: workspace does not exist: $workspace" >&2
+    exit 1
+fi
+
+cd -- "$workspace"
+
+# Reattach every browser connection to the same terminal session. Closing the browser detaches
+# the client but leaves Claude Code and other commands running inside tmux.
+exec tmux new-session -A -s "$session_name" -c "$workspace"

claude_desktop/rootfs/usr/local/bin/claude-tools-doctor.sh

@@ -1,174 +0,0 @@
-#!/usr/bin/with-contenv bashio
-# Diagnose installation, registration, routing, indexing, permissions, and recorded savings without
-# printing MCP environment values (which may contain the Home Assistant access token).
-# shellcheck shell=bash
-set +e
-set -o pipefail
-export NO_COLOR=1
-export PATH="/lsiopy/bin:/usr/local/bin:/usr/bin:/bin:${PATH}"
-
-section() {
-    printf '\n=== %s ===\n' "$1"
-}
-
-section "Installed binaries"
-for tool in claude claude-desktop headroom rtk tokensave git gh rg jq shellcheck yamllint hadolint actionlint; do
-    resolved="$(command -v "$tool" 2> /dev/null || true)"
-    if [ -n "$resolved" ]; then
-        printf '%-16s %s\n' "$tool" "$resolved"
-    else
-        printf '%-16s %s\n' "$tool" "MISSING"
-    fi
-done
-
-section "Configured switches"
-for option in permission_mode install_headroom headroom_wrap_claude_code expose_headroom_dashboard install_rtk install_tokensave install_caveman enable_tools_health_report; do
-    printf '%-30s %s\n' "$option" "$(bashio::config "$option")"
-done
-
-section "Runtime identity"
-printf '%-30s %s\n' "configured PUID:PGID" "$(bashio::config 'PUID'):$(bashio::config 'PGID')"
-printf '%-30s %s\n' "effective abc UID:GID" "$(id -u abc):$(id -g abc)"
-printf '%-30s %s\n' "current process UID:GID" "$(id -u):$(id -g)"
-if [ "$(bashio::config 'permission_mode')" = "bypass" ]; then
-    if [ "$(id -u abc)" -eq 0 ]; then
-        echo "bypass runtime: ERROR - Claude Code will reject bypass permissions while abc is root"
-    else
-        echo "bypass runtime: OK - Claude Desktop and Cowork run as a non-root UID"
-    fi
-fi
-
-section "Claude Code permission state"
-python3 - <<'PY'
-import json
-from pathlib import Path
-
-path = Path.home() / ".claude/settings.json"
-try:
-    data = json.loads(path.read_text())
-except FileNotFoundError:
-    print("settings: MISSING")
-except Exception as exc:
-    print(f"settings: INVALID: {exc}")
-else:
-    permissions = data.get("permissions", {})
-    if isinstance(permissions, dict):
-        print(f"permissions.defaultMode: {permissions.get('defaultMode', '<upstream default>')}")
-    else:
-        print("permissions: INVALID")
-print(f"managed-state marker: {(Path.home() / '.claude/.addon-permission-mode.json').exists()}")
-PY
-
-section "MCP registrations (environment values redacted)"
-python3 - <<'PY'
-import json
-from pathlib import Path
-
-paths = [
-    Path.home() / ".claude.json",
-    Path.home() / ".config/Claude/claude_desktop_config.json",
-]
-for path in paths:
-    print(path)
-    try:
-        data = json.loads(path.read_text())
-    except FileNotFoundError:
-        print("  MISSING")
-        continue
-    except Exception as exc:
-        print(f"  INVALID: {exc}")
-        continue
-    servers = data.get("mcpServers", {})
-    if not isinstance(servers, dict) or not servers:
-        print("  no MCP servers")
-        continue
-    for name, spec in sorted(servers.items()):
-        if not isinstance(spec, dict):
-            print(f"  {name}: invalid entry")
-            continue
-        command = spec.get("command", "?")
-        args = spec.get("args", [])
-        server_type = spec.get("type", "")
-        suffix = f" type={server_type}" if server_type else ""
-        print(f"  {name}: {command} {args}{suffix}")
-        if spec.get("env"):
-            print("    env: <redacted>")
-PY
-
-section "Claude Code hooks"
-python3 - <<'PY'
-import json
-from pathlib import Path
-
-path = Path.home() / ".claude/settings.json"
-try:
-    data = json.loads(path.read_text())
-except FileNotFoundError:
-    print("MISSING")
-    raise SystemExit(0)
-except Exception as exc:
-    print(f"INVALID: {exc}")
-    raise SystemExit(0)
-
-hooks = data.get("hooks", {})
-if not isinstance(hooks, dict) or not hooks:
-    print("no hooks")
-    raise SystemExit(0)
-for event, entries in hooks.items():
-    print(event)
-    if not isinstance(entries, list):
-        print("  invalid entries")
-        continue
-    for entry in entries:
-        matcher = entry.get("matcher", "*") if isinstance(entry, dict) else "?"
-        commands = entry.get("hooks", []) if isinstance(entry, dict) else []
-        rendered = []
-        for command in commands if isinstance(commands, list) else []:
-            if isinstance(command, dict):
-                rendered.append(" ".join([str(command.get("command", "?")), *map(str, command.get("args", []))]))
-        print(f"  matcher={matcher}: {', '.join(rendered) or 'no command'}")
-PY
-
-section "Headroom"
-if bashio::config.true 'install_headroom'; then
-    curl -fsS --max-time 2 http://127.0.0.1:8787/health && echo || echo "proxy health: FAILED"
-    headroom mcp status || true
-    headroom savings || true
-else
-    echo "disabled"
-fi
-
-section "RTK"
-if bashio::config.true 'install_rtk'; then
-    rtk gain || true
-else
-    echo "disabled"
-fi
-
-section "TokenSave"
-if bashio::config.true 'install_tokensave'; then
-    tokensave doctor --agent claude || true
-    tokensave gain --all --range 30d || true
-    while IFS= read -r configured_path; do
-        [ -n "$configured_path" ] || continue
-        repo_root="$(s6-setuidgid abc env HOME="$HOME" git -c safe.directory='*' -C "$configured_path" rev-parse --show-toplevel 2> /dev/null || true)"
-        if [ -z "$repo_root" ]; then
-            echo "${configured_path}: not a Git repository"
-        elif [ -f "$repo_root/.tokensave/tokensave.db" ]; then
-            s6-setuidgid abc env HOME="$HOME" tokensave status "$repo_root" --short || true
-        else
-            echo "${repo_root}: NOT INITIALIZED"
-        fi
-    done < <(bashio::config.array 'tokensave_project_paths')
-else
-    echo "disabled"
-fi
-
-section "Claude routing"
-printf 'PATH claude: %s\n' "$(command -v claude 2> /dev/null || true)"
-printf 'real claude: %s\n' "$([ -x /usr/bin/claude ] && echo /usr/bin/claude || echo MISSING)"
-if bashio::config.true 'headroom_wrap_claude_code'; then
-    echo "PATH-based Claude Code launches are configured for Headroom wrapping."
-else
-    echo "Claude Code Headroom wrapping is disabled; Headroom remains available through MCP."
-fi

claude_desktop/updater.json

@@ -3,7 +3,5 @@
   "upstream_repo": "linuxserver/docker-baseimage-selkies",
   "github_fulltag": true,
   "slug": "claude_desktop",
-  "paused": false,
-  "upstream_version": "ubunturesolute-version-6dc44b0e",
-  "last_update": "2026-07-13"
+  "paused": false
 }

cleanuparr/CHANGELOG.md

@@ -1,7 +1,4 @@
  
-## 2.9.16 (2026-07-11)
-- Update to latest version from Cleanuparr/Cleanuparr (changelog : https://github.com/Cleanuparr/Cleanuparr/releases)
- 
 ## 2.9.14 (2026-06-20)
 - Update to latest version from Cleanuparr/Cleanuparr (changelog : https://github.com/Cleanuparr/Cleanuparr/releases)
 

cleanuparr/Dockerfile

@@ -11,7 +11,7 @@
 #=== Home Assistant Addon ===#
 
 # ARGs used in FROM must be declared before any FROM instruction
-ARG BUILD_UPSTREAM="2.9.16"
+ARG BUILD_UPSTREAM="2.9.14"
 
 #################
 # 1 Build Image #

cleanuparr/config.yaml

@@ -91,5 +91,5 @@ schema:
   TZ: str?
 slug: cleanuparr
 url: https://github.com/alexbelgium/hassio-addons/tree/master/cleanuparr
-version: "2.9.16"
+version: "2.9.14"
 webui: "[PROTO:ssl]://[HOST]:[PORT:11011]"

cleanuparr/updater.json

@@ -1,8 +1,8 @@
 {
-  "last_update": "2026-07-11",
+  "last_update": "2026-06-20",
   "repository": "alexbelgium/hassio-addons",
   "slug": "cleanuparr",
   "source": "github",
   "upstream_repo": "Cleanuparr/Cleanuparr",
-  "upstream_version": "2.9.16"
+  "upstream_version": "2.9.14"
 }

codex/CHANGELOG.md

@@ -1,7 +1,4 @@
  
-## 2.1.2 (2026-07-11)
-- Update to latest version from ajslater/codex (changelog : https://github.com/ajslater/codex/releases)
- 
 ## 2.1.0 (2026-07-04)
 - Update to latest version from ajslater/codex (changelog : https://github.com/ajslater/codex/releases)
  

codex/config.yaml

@@ -101,4 +101,4 @@ schema:
 slug: codex
 udev: true
 url: https://github.com/alexbelgium/hassio-addons
-version: "2.1.2"
+version: "2.1.0"

codex/updater.json

@@ -1,9 +1,9 @@
 {
   "github_beta": "true",
-  "last_update": "2026-07-11",
+  "last_update": "2026-07-04",
   "repository": "alexbelgium/hassio-addons",
   "slug": "codex",
   "source": "github",
   "upstream_repo": "ajslater/codex",
-  "upstream_version": "2.1.2"
+  "upstream_version": "2.1.0"
 }

elasticsearch/CHANGELOG.md

@@ -1,24 +1,3 @@
-## 8.19.18-3 (14-07-2026)
-- Force a fresh image pull for users left on a stale cached image (some upgrades kept running the old Elasticsearch 7.17.9 image, failing with `mv: cannot move '/data/config' ... Permission denied` and `AccessDeniedException[/usr/share/elasticsearch/data/nodes/0]`). Fully stop and update the add-on so Home Assistant pulls this build.
-- Replaced the cryptic `Permission denied` failure with a clear message when the add-on is not running as root (the state that caused the failure above).
-
-## 8.19.18-2 (14-07-2026)
-- Minor bugs fixed
-## 8.19.18 (2026-07-14)
-
-- Upgrade to Elasticsearch 8.19.18 (#2849). Note: despite the previous add-on version reading `8.14.3`, the shipped image was still Elasticsearch 7.17.9 — the Dockerfile upstream version was never bumped. This release actually delivers 8.x, making the add-on compatible with the `homeassistant-elasticsearch` integration (requires 8.14+).
-- Automatic data migration: existing 7.17 data is upgraded in place by Elasticsearch on first start (one-way; can take a while on large datasets). A migration guard aborts with a clear message on unsupported paths (downgrades, or data more than one major version old). Take a Home Assistant backup before updating.
-- The previous bundled config directory is archived to `/data/config.bak-<old-version>` during major upgrades; re-apply custom settings to the new config if needed.
-- Security (`xpack.security.enabled`) defaults to `false` to preserve the previous plain-HTTP behavior. Override by adding `ES_SETTING_XPACK_SECURITY_ENABLED` (or any `ES_SETTING_XPACK_SECURITY_*` variable) in the add-on's `env_vars` option.
-- Fixed the `env_vars` add-on option, which previously had no effect: variables are now exported before Elasticsearch starts.
-- Removed the `ingest-attachment` plugin install: it is a bundled module since Elasticsearch 8.0.
-- Startup persistence logic rewritten as a proper init script (`/usr/local/bin/addon-init.sh`) instead of line-number-based entrypoint patching.
-- Added `updater.json` so upstream 8.19.x releases are tracked automatically (pinned to the 8.19 line: 9.x cannot read indices created in 7.x).
-- The upstream 8.x image ends the build as a non-root user with a read-only entrypoint; the Dockerfile now switches to root for the build steps that patch/install into it. The container also starts as root (unchanged from 7.17.9) so `addon-init.sh` can chown/move pre-existing `/data` content that may be owned by root from earlier installs; unlike 7.17.9's own entrypoint, the upstream 8.x entrypoint no longer drops privileges before starting Elasticsearch (which refuses to run as root), so `addon-init.sh` now does that itself via `chroot --userspec=1000:0` once its root-only work is done.
-- `env_vars` names starting with a digit are now rejected before export instead of crashing the entrypoint.
-- Fixed a startup failure (`mv: cannot move '/data/config' ... Permission denied`) on upgrade from an existing 7.17.9 install, caused by an earlier fix in this same release that switched the runtime user to non-root before this fix was in place.
-- Fixed a second regression from that same fix: without a privilege drop before starting Elasticsearch, both fresh installs and upgrades would fail Elasticsearch's own root-check ("can not run elasticsearch as root").
-
 ## 8.14.3-3 (2026-06-19)
 - Fix startup failing with `chroot: cannot change root directory` by allowing `capability sys_chroot` in the AppArmor profile (#2709)
 - Fix AppArmor profile name (was `inadyn_addon`, colliding with several other add-ons); renamed to `elasticsearch_addon`

elasticsearch/Dockerfile

@@ -14,14 +14,9 @@
 # 1 Build Image #
 #################
 
-ARG BUILD_UPSTREAM="8.19.18"
+ARG BUILD_UPSTREAM="7.17.9"
 FROM elasticsearch:$BUILD_UPSTREAM
 
-# The base image ends as USER 1000:0 with a root-owned, read-only (0555)
-# entrypoint; switch back to root for the remaining build steps (entrypoint
-# patch, package install, chmod), then restore the Elasticsearch user below
-USER root
-
 ##################
 # 2 Modify Image #
 ##################
@@ -31,15 +26,20 @@ ENV S6_CMD_WAIT_FOR_SERVICES=1 \
     S6_CMD_WAIT_FOR_SERVICES_MAXTIME=0 \
     S6_SERVICES_GRACETIME=0
 
-# Expose the upstream version to the add-on init script (migration guard)
-ARG BUILD_UPSTREAM
-ENV UPSTREAM_VERSION="$BUILD_UPSTREAM"
 
-# Data persistence & migration: source the add-on init script at the top of
-# the official entrypoint (pattern-anchored; ingest-attachment is bundled
-# since ES 8.0 so no plugin install is needed anymore)
-RUN sed -i '/^set -e$/a . /usr/local/bin/addon-init.sh' /usr/local/bin/docker-entrypoint.sh \
-    && grep -q "addon-init.sh" /usr/local/bin/docker-entrypoint.sh
+# Data persistence
+# hadolint ignore=SC2016
+RUN sed -i '5a echo "Data location moved. Please wait while elasticsearch starts..."' /usr/local/bin/docker-entrypoint.sh \
+    && sed -i '5a chown -R $(id -u):$(id -g) $HOME' /usr/local/bin/docker-entrypoint.sh \
+    && sed -i '5a done' /usr/local/bin/docker-entrypoint.sh \
+    && sed -i '5a ln -s $NEWHOME/$file /usr/share/elasticsearch || true' /usr/local/bin/docker-entrypoint.sh \
+    && sed -i '5a rm -r /usr/share/elasticsearch/$file || true' /usr/local/bin/docker-entrypoint.sh \
+    && sed -i '5a cp -rn /usr/share/elasticsearch/$file $NEWHOME || true' /usr/local/bin/docker-entrypoint.sh \
+    && sed -i '5a for file in "data" "config"; do' /usr/local/bin/docker-entrypoint.sh \
+    && sed -i '5a mkdir -p $NEWHOME' /usr/local/bin/docker-entrypoint.sh \
+    && sed -i '5a NEWHOME="/data"' /usr/local/bin/docker-entrypoint.sh \
+    # Install plugins
+    && /usr/share/elasticsearch/bin/elasticsearch-plugin install --batch ingest-attachment
 
 ##################
 # 3 Install apps #
@@ -62,7 +62,7 @@ COPY ha_automodules.sh /ha_automodules.sh
 RUN chmod 744 /ha_automodules.sh && /ha_automodules.sh "$MODULES" && rm /ha_automodules.sh
 
 # Manual apps
-ENV PACKAGES="jq"
+ENV PACKAGES=""
 
 # Automatic apps & bashio
 COPY ha_autoapps.sh /ha_autoapps.sh
@@ -140,11 +140,3 @@ HEALTHCHECK \
     --start-period=30s \
     --timeout=25s \
     CMD curl -A "HealthCheck: Docker/1.0" -s -f "http://127.0.0.1:${HEALTH_PORT}${HEALTH_URL}" &>/dev/null || exit 1
-
-# Start as root: addon-init.sh needs it to chown/move pre-existing /data
-# content that may be owned by root from earlier installs. It drops to
-# uid 1000 itself (via chroot --userspec) before Elasticsearch actually
-# starts, since Elasticsearch refuses to run as root and the upstream 8.x
-# entrypoint no longer does that drop on its own (7.x's did). This matches
-# the addon's own AppArmor profile (chown, setuid, setgid, sys_chroot,
-# mount capabilities).

elasticsearch/README.md

@@ -91,22 +91,6 @@ Connect other applications to Elasticsearch using:
 
 Use the add-on `env_vars` option to pass extra environment variables (uppercase or lowercase names). See https://github.com/alexbelgium/hassio-addons/wiki/Add-Environment-variables-to-your-Addon-2 for details.
 
-Elasticsearch settings can be set through variables named `ES_SETTING_<SETTING_WITH_UNDERSCORES>`; for example `ES_SETTING_XPACK_SECURITY_ENABLED` maps to `xpack.security.enabled`.
-
-### Security
-
-To preserve the plain-HTTP behavior of previous versions (and compatibility with the Home Assistant Elasticsearch integration), `xpack.security.enabled` defaults to `false`. To enable Elasticsearch security, add `ES_SETTING_XPACK_SECURITY_ENABLED` with value `true` in `env_vars`.
-
-## Upgrading from 7.x
-
-The upgrade to Elasticsearch 8.x is automatic and **one-way**:
-
-1. Take a Home Assistant backup of the add-on before updating.
-2. Update the add-on and start it. Elasticsearch upgrades the existing indices in place on first start — this can take a while on large datasets; do **not** stop the add-on during the first start.
-3. The previous bundled config directory is archived to `/data/config.bak-<old-version>`; re-apply any custom settings to the new config.
-
-Downgrading afterwards is not supported by Elasticsearch — restore the backup instead.
-
 ## Integration with HA
 
 Component : https://community.home-assistant.io/t/elasticsearch-component-publish-home-assistant-events-to-elasticsearch/66877

elasticsearch/config.yaml

@@ -90,4 +90,4 @@ slug: elasticsearch
 startup: services
 udev: true
 url: https://github.com/alexbelgium/hassio-addons/tree/master/elasticsearch
-version: 8.19.18-3
+version: 8.14.3-3

elasticsearch/rootfs/etc/cont-init.d/99-run.sh

@@ -0,0 +1 @@
+#!/bin/bash

elasticsearch/rootfs/usr/local/bin/addon-init.sh

@@ -1,182 +0,0 @@
-#!/bin/bash
-# shellcheck shell=bash
-# Sourced by /usr/local/bin/docker-entrypoint.sh (right after "set -e"),
-# before Elasticsearch starts. The container starts as root (see
-# Dockerfile) so this script can chown/move pre-existing /data content
-# that may be owned by root from earlier installs. Elasticsearch itself
-# refuses to run as root, and unlike 7.x the upstream 8.x entrypoint no
-# longer drops privileges on its own, so this script does it at the end
-# (section 6) by re-execing the entrypoint as uid 1000. On that re-exec'd
-# pass this script just returns immediately (see the guard right below).
-#
-# Responsibilities:
-#   1. Export user env_vars from /data/options.json
-#   2. Default xpack.security.enabled=false (7.x behavior) unless user overrides
-#   3. Relocate data & config to /data for persistence (idempotent)
-#   4. Guard major-version data migrations (7.x -> 8.x is automatic)
-#   5. Record the running version once Elasticsearch is confirmed healthy
-#   6. Drop root privileges before Elasticsearch actually starts
-
-if [ -n "${_ADDON_INIT_REEXEC:-}" ]; then
-    return 0
-fi
-
-echo "-----------------------------------------------------------"
-echo " Add-on: Elasticsearch server"
-echo " Upstream version: ${UPSTREAM_VERSION:-unknown}"
-echo "-----------------------------------------------------------"
-
-ES_HOME="/usr/share/elasticsearch"
-PERSISTENT_HOME="/data"
-VERSION_MARKER="$PERSISTENT_HOME/.addon-upstream-version"
-OPTIONS_JSON="/data/options.json"
-
-# This first pass must be root so it can relocate and take ownership of
-# pre-existing /data content written by an earlier (root) install. If it
-# is not root (e.g. an old cached image that pinned USER 1000:0, or the
-# container being forced to another user), the moves/chowns below fail
-# with a cryptic "Permission denied"; fail loudly with the real reason.
-if [ "$(id -u)" -ne 0 ]; then
-    echo "FATAL: the Elasticsearch add-on must start as root (currently uid $(id -u))."
-    echo "If you upgraded from an older version, the running image is likely stale - fully stop and update/reinstall the add-on so Home Assistant pulls the current image."
-    exit 1
-fi
-
-############################
-# 1 Export user env_vars   #
-############################
-
-if [ -f "$OPTIONS_JSON" ] && command -v jq >/dev/null 2>&1; then
-    while IFS= read -r pair; do
-        name=$(jq -r '.name // empty' <<<"$pair")
-        value=$(jq -r '.value // empty' <<<"$pair")
-        if [[ $name =~ ^[A-Za-z_][A-Za-z0-9_]*$ ]]; then
-            echo "Setting env variable from options: $name"
-            export "$name"="$value"
-        elif [ -n "$name" ]; then
-            echo "WARNING: ignoring invalid env_vars name: $name"
-        fi
-    done < <(jq -c '.env_vars[]?' "$OPTIONS_JSON" 2>/dev/null || true)
-fi
-
-##################################
-# 2 Security default (7.x parity)#
-##################################
-
-# ES 8+ enables security + TLS by default, which breaks plain-http clients
-# such as the homeassistant-elasticsearch component. Keep the previous 7.x
-# behavior unless the user explicitly configures xpack.security themselves
-# (either as a dotted setting or via the ES_SETTING_* translation).
-if ! env | grep -qiE '^(xpack\.security\.|ES_SETTING_XPACK_SECURITY_)'; then
-    export ES_SETTING_XPACK_SECURITY_ENABLED=false
-    echo "Security: xpack.security.enabled=false (default; override by setting ES_SETTING_XPACK_SECURITY_ENABLED in env_vars)"
-fi
-
-############################
-# 3 Migration guard        #
-############################
-
-current_version="${UPSTREAM_VERSION:-0.0.0}"
-current_major="${current_version%%.*}"
-data_version=""
-
-if [ -f "$VERSION_MARKER" ]; then
-    data_version="$(head -n 1 "$VERSION_MARKER" | tr -cd '0-9.')"
-elif [ -d "$PERSISTENT_HOME/data" ] && [ -n "$(ls -A "$PERSISTENT_HOME/data" 2>/dev/null)" ]; then
-    # Existing data without a marker: only 7.17.9 was ever shipped before markers
-    data_version="7.17.9"
-fi
-
-if [ -n "$data_version" ] && [[ $current_major =~ ^[0-9]+$ ]]; then
-    data_major="${data_version%%.*}"
-    if [ "$data_major" -gt "$current_major" ]; then
-        echo "FATAL: existing data was written by Elasticsearch $data_version but this add-on runs $current_version."
-        echo "Downgrading Elasticsearch data is not supported. Restore a Home Assistant snapshot taken with the newer version, or delete the add-on data to start fresh."
-        exit 1
-    elif [ "$((current_major - data_major))" -gt 1 ]; then
-        echo "FATAL: existing data was written by Elasticsearch $data_version, which is more than one major version behind $current_version."
-        echo "Elasticsearch can only upgrade data from the previous major version. Upgrade stepwise (e.g. $data_major.x -> $((data_major + 1)).x -> ...) or delete the add-on data to start fresh."
-        exit 1
-    elif [ "$data_major" -lt "$current_major" ]; then
-        echo "NOTICE: one-time automatic data migration from Elasticsearch $data_version to $current_version."
-        echo "NOTICE: indices are upgraded automatically on startup. This can take a while on large datasets - do NOT stop the add-on during the first start."
-        # The bundled config from the old major is stale (jvm.options, log4j2,
-        # security settings). Archive it so a fresh one is seeded below.
-        if [ -d "$PERSISTENT_HOME/config" ] && [ ! -L "$PERSISTENT_HOME/config" ]; then
-            config_backup="$PERSISTENT_HOME/config.bak-$data_version"
-            if [ ! -e "$config_backup" ]; then
-                if ! mv "$PERSISTENT_HOME/config" "$config_backup"; then
-                    echo "FATAL: could not archive the old config to $config_backup."
-                    echo "This add-on must run as root to migrate a previous install. Restore a Home Assistant backup and ensure the add-on is not forced to a non-root user."
-                    exit 1
-                fi
-                echo "NOTICE: previous config archived to $config_backup. Re-apply any custom settings to the new config."
-            fi
-        fi
-        # The container config dir may still symlink to the archived config
-        if [ -L "$ES_HOME/config" ]; then
-            rm -f "$ES_HOME/config"
-        fi
-    fi
-fi
-
-############################
-# 4 Data persistence       #
-############################
-
-mkdir -p "$PERSISTENT_HOME"
-for dir in "data" "config"; do
-    if [ ! -L "$ES_HOME/$dir" ]; then
-        if [ -d "$ES_HOME/$dir" ]; then
-            cp -rn "$ES_HOME/$dir" "$PERSISTENT_HOME" 2>/dev/null || true
-            rm -rf "${ES_HOME:?}/$dir"
-        fi
-        mkdir -p "$PERSISTENT_HOME/$dir"
-        ln -s "$PERSISTENT_HOME/$dir" "$ES_HOME/$dir"
-    fi
-done
-
-# Make the persisted files usable by the elasticsearch user (uid 1000),
-# which the official entrypoint drops to when started as root
-if [ "$(id -u)" -eq 0 ]; then
-    chown -R 1000:0 "$PERSISTENT_HOME/data" "$PERSISTENT_HOME/config" 2>/dev/null || true
-fi
-
-echo "Data location: $PERSISTENT_HOME (persistent). Please wait while elasticsearch starts..."
-
-############################
-# 5 Record data version    #
-############################
-
-# Only record the running version once ES is confirmed healthy, so a failed
-# upgrade attempt never masks the true on-disk data lineage
-if [ "$data_version" != "$current_version" ]; then
-    (
-        for _ in $(seq 1 180); do
-            # Check the HTTP status directly instead of curl -f: a 401 means
-            # Elasticsearch is up and answering (security just requires
-            # auth), so it must count as healthy too, not as a failure.
-            status=$(curl -A "HealthCheck: Docker/1.0" -s -o /dev/null -w '%{http_code}' "http://127.0.0.1:9200" 2>/dev/null || true)
-            if [ "$status" = "200" ] || [ "$status" = "401" ]; then
-                echo "$current_version" >"$VERSION_MARKER"
-                echo "Elasticsearch $current_version started successfully; data version recorded."
-                exit 0
-            fi
-            sleep 10
-        done
-    ) &
-fi
-
-############################
-# 6 Drop privileges        #
-############################
-
-# Elasticsearch refuses to start as root ("can not run elasticsearch as
-# root"). 7.x's own entrypoint dropped to uid 1000 via chroot before
-# launching Elasticsearch; 8.x no longer does that, so do it here instead,
-# then let the entrypoint continue as uid 1000 (matches the sys_chroot /
-# setuid / setgid capabilities already granted in the AppArmor profile).
-if [ "$(id -u)" -eq 0 ]; then
-    export _ADDON_INIT_REEXEC=1
-    exec chroot --userspec=1000:0 / /usr/local/bin/docker-entrypoint.sh "$@"
-fi

elasticsearch/updater.json

@@ -1,10 +0,0 @@
-{
-  "github_fulltag": false,
-  "github_tagfilter": "v8.19",
-  "last_update": "14-07-2026",
-  "repository": "alexbelgium/hassio-addons",
-  "slug": "elasticsearch",
-  "source": "github",
-  "upstream_repo": "elastic/elasticsearch",
-  "upstream_version": "8.19.18"
-}

emby_beta/CHANGELOG.md

@@ -1,10 +1,4 @@
  
-## 4.10.0.19 (2026-07-13)
-- Update to latest version from linuxserver/docker-emby (changelog : https://github.com/linuxserver/docker-emby/releases)
- 
-## 4.10.0.18 (2026-07-11)
-- Update to latest version from linuxserver/docker-emby (changelog : https://github.com/linuxserver/docker-emby/releases)
- 
 ## 4.10.0.17 (2026-07-04)
 - Update to latest version from linuxserver/docker-emby (changelog : https://github.com/linuxserver/docker-emby/releases)
  

emby_beta/Dockerfile

@@ -16,7 +16,7 @@
 
 ARG BUILD_FROM
 ARG BUILD_VERSION
-ARG BUILD_UPSTREAM="4.10.0.19"
+ARG BUILD_UPSTREAM="4.10.0.17"
 FROM ${BUILD_FROM}
 
 ##################