v1.1.0

Author: CoderLuii

.github/workflows/docker-publish.yml

@@ -1,4 +1,4 @@
-name: HolyClaude — Build & Push to Docker Hub
+name: HolyClaude — Build & Push to Docker Hub + GHCR
 
 on:
   workflow_dispatch:
@@ -12,17 +12,19 @@ concurrency:
 
 env:
   DOCKERHUB_IMAGE: coderluii/holyclaude
+  GHCR_IMAGE: ghcr.io/coderluii/holyclaude
 
 jobs:
   build-and-push:
     runs-on: ubuntu-latest
     permissions:
       contents: read
+      packages: write
 
     strategy:
       max-parallel: 1
       matrix:
-        variant: [full, slim]
+        variant: [slim, full]
 
     steps:
       - name: Checkout
@@ -47,19 +49,25 @@ jobs:
           username: ${{ secrets.DOCKERHUB_USERNAME }}
           password: ${{ secrets.DOCKERHUB_TOKEN }}
 
+      - name: Login to GHCR
+        uses: docker/login-action@v4
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GHCR_TOKEN }}
+
       - name: Extract metadata
         id: meta
         uses: docker/metadata-action@v6
         with:
           images: |
             ${{ env.DOCKERHUB_IMAGE }}
+            ${{ env.GHCR_IMAGE }}
           tags: |
             type=raw,value=latest,enable=${{ matrix.variant == 'full' }}
             type=raw,value=slim,enable=${{ matrix.variant == 'slim' }}
             type=semver,pattern={{version}},enable=${{ matrix.variant == 'full' }}
             type=semver,pattern={{version}}-slim,enable=${{ matrix.variant == 'slim' }}
-            type=semver,pattern={{major}}.{{minor}},enable=${{ matrix.variant == 'full' }}
-            type=semver,pattern={{major}}.{{minor}}-slim,enable=${{ matrix.variant == 'slim' }}
 
       - name: Build and push
         uses: docker/build-push-action@v7

Dockerfile

@@ -9,6 +9,8 @@
 
 FROM node:22-bookworm-slim
 
+LABEL org.opencontainers.image.source=https://github.com/CoderLuii/HolyClaude
+
 # ---------- Build args ----------
 ARG S6_OVERLAY_VERSION=3.2.0.2
 ARG TARGETARCH
@@ -124,7 +126,8 @@ RUN pip install --no-cache-dir --break-system-packages \
     openpyxl python-docx \
     jinja2 pyyaml python-dotenv markdown \
     rich click tqdm \
-    playwright
+    playwright \
+    apprise
 
 # ---------- Python packages (full only) ----------
 RUN if [ "$VARIANT" = "full" ]; then \
@@ -163,13 +166,13 @@ RUN echo "${VARIANT}" > /etc/holyclaude-variant
 # ---------- Copy config files ----------
 COPY scripts/entrypoint.sh /usr/local/bin/entrypoint.sh
 COPY scripts/bootstrap.sh /usr/local/bin/bootstrap.sh
-COPY scripts/notify.sh /usr/local/bin/notify.sh
+COPY scripts/notify.py /usr/local/bin/notify.py
 COPY config/settings.json /usr/local/share/holyclaude/settings.json
 COPY config/claude-memory-full.md /usr/local/share/holyclaude/claude-memory-full.md
 COPY config/claude-memory-slim.md /usr/local/share/holyclaude/claude-memory-slim.md
 RUN chmod +x /usr/local/bin/entrypoint.sh \
     /usr/local/bin/bootstrap.sh \
-    /usr/local/bin/notify.sh
+    /usr/local/bin/notify.py
 
 # ---------- s6-overlay service definitions ----------
 COPY s6-overlay/s6-rc.d/cloudcli/type /etc/s6-overlay/s6-rc.d/cloudcli/type

README.md

@@ -219,10 +219,10 @@ Two flavors. Same quality. Pick your weight class.
 
 ```bash
 # Full — batteries included (recommended)
-docker pull CoderLuii/HolyClaude
+docker pull coderluii/holyclaude
 
 # Slim — lean and mean
-docker pull CoderLuii/HolyClaude:slim
+docker pull coderluii/holyclaude:slim
 ```
 
 > **`latest` is always the full image.** Slim users: don't worry — when you ask Claude to do something that needs a missing tool, it installs it in seconds. You get the same capabilities, just with a smaller initial download.
@@ -246,7 +246,7 @@ The "I just want it running" template. Copy this entire block into a `docker-com
 
 services:
   holyclaude:
-    image: CoderLuii/HolyClaude:latest     # Full image (use :slim for smaller download)
+    image: coderluii/holyclaude:latest     # Full image (use :slim for smaller download)
     container_name: holyclaude
     hostname: holyclaude
     restart: unless-stopped
@@ -308,7 +308,7 @@ Same image, every knob exposed. Copy this entire block into a `docker-compose.ya
 
 services:
   holyclaude:
-    image: CoderLuii/HolyClaude:latest     # Full image (use :slim for smaller download)
+    image: coderluii/holyclaude:latest     # Full image (use :slim for smaller download)
     container_name: holyclaude
     hostname: holyclaude
     restart: unless-stopped
@@ -374,13 +374,18 @@ services:
       # - CHOKIDAR_USEPOLLING=1
       # - WATCHFILES_FORCE_POLLING=true
       #
-      # PUSH NOTIFICATIONS (optional)
-      # Get notified on your phone when Claude finishes a task or hits an error.
-      # Uses Pushover (https://pushover.net). Also requires creating a flag file
+      # NOTIFICATIONS (optional)
+      # Get notified when Claude finishes a task or hits an error.
+      # Uses Apprise — supports 100+ services. Also requires creating a flag file
       # inside the container: touch ~/.claude/notify-on
       #
-      # - PUSHOVER_APP_TOKEN=your_token
-      # - PUSHOVER_USER_KEY=your_key
+      # - NOTIFY_DISCORD=discord://webhook_id/webhook_token
+      # - NOTIFY_TELEGRAM=tg://bot_token/chat_id
+      # - NOTIFY_PUSHOVER=pover://user_key@app_token
+      # - NOTIFY_SLACK=slack://token_a/token_b/token_c
+      # - NOTIFY_EMAIL=mailto://user:pass@gmail.com?to=you@gmail.com
+      # - NOTIFY_GOTIFY=gotify://hostname/token
+      # - NOTIFY_URLS=                                   # catch-all: comma-separated Apprise URLs
       #
       # AI PROVIDER API KEYS (optional)
       # These are for the OTHER AI CLIs — not Claude Code itself.
@@ -406,7 +411,7 @@ docker compose up -d
 | **Performance** | Node.js memory ceiling | Only if you hit OOM errors on large projects |
 | **User mapping** | File permissions between container and host | If you get "permission denied" (`id -u` and `id -g` on your host) |
 | **SMB/CIFS** | File watcher polling mode | Only if your volumes live on a NAS or network share |
-| **Notifications** | Push alerts to your phone via Pushover | If you want to walk away and know when Claude is done |
+| **Notifications** | Push alerts via Apprise (Discord, Telegram, Slack, Email, 100+ services) | If you want to walk away and know when Claude is done |
 | **AI providers** | API keys for Gemini, Codex, Cursor | If you want to use AI CLIs other than Claude |
 
 > **Every single environment variable is optional.** The container runs perfectly with just `TZ=UTC`. Everything else has sensible defaults or is handled through the web UI.
@@ -431,8 +436,13 @@ The complete reference. Every variable, what it defaults to, what it does.
 | `GIT_USER_EMAIL` | `noreply@holyclaude.local` | Git commit email (set once on first boot) |
 | `CHOKIDAR_USEPOLLING` | *(unset)* | Set to `1` for SMB/CIFS — enables polling file watchers |
 | `WATCHFILES_FORCE_POLLING` | *(unset)* | Set to `true` for SMB/CIFS — enables Python polling |
-| `PUSHOVER_APP_TOKEN` | *(unset)* | Pushover app token for push notifications |
-| `PUSHOVER_USER_KEY` | *(unset)* | Pushover user key for push notifications |
+| `NOTIFY_DISCORD` | *(unset)* | Discord webhook URL for notifications |
+| `NOTIFY_TELEGRAM` | *(unset)* | Telegram bot URL for notifications |
+| `NOTIFY_PUSHOVER` | *(unset)* | Pushover URL for notifications |
+| `NOTIFY_SLACK` | *(unset)* | Slack webhook URL for notifications |
+| `NOTIFY_EMAIL` | *(unset)* | Email (SMTP) URL for notifications |
+| `NOTIFY_GOTIFY` | *(unset)* | Gotify URL for notifications |
+| `NOTIFY_URLS` | *(unset)* | Catch-all — comma-separated [Apprise URLs](https://github.com/caronc/apprise/wiki) |
 | `GEMINI_API_KEY` | *(unset)* | Google Gemini API key |
 | `OPENAI_API_KEY` | *(unset)* | OpenAI API key (for Codex CLI — NOT ChatGPT) |
 | `CURSOR_API_KEY` | *(unset)* | Cursor API key |
@@ -661,7 +671,7 @@ holyclaude/
 ├── scripts/                 # Container lifecycle scripts
 │   ├── bootstrap.sh         # First-run setup
 │   ├── entrypoint.sh        # Container entrypoint
-│   └── notify.sh            # Notification helper
+│   └── notify.py            # Notification helper (Apprise)
 ├── s6-overlay/              # Process supervision (s6-rc services)
 ├── Dockerfile               # Single-stage build
 ├── docker-compose.yaml      # Quick start (minimal config)
@@ -742,17 +752,19 @@ This is how I personally run it. Edit `./data/claude/settings.json` on your host
 
 ## :bell: Notifications
 
-Walk away from your computer and know when Claude is done. Uses [Pushover](https://pushover.net/) for push notifications to your phone.
+Walk away from your computer and know when Claude is done. Uses [Apprise](https://github.com/caronc/apprise) for notifications — supports 100+ services including Discord, Telegram, Slack, Email, Pushover, Gotify, and more.
 
 **To enable:**
 
-1. Add to your compose `environment`:
+1. Add one or more `NOTIFY_*` variables to your compose `environment`:
    ```yaml
-   - PUSHOVER_APP_TOKEN=your_token
-   - PUSHOVER_USER_KEY=your_key
+   - NOTIFY_DISCORD=discord://webhook_id/webhook_token
+   - NOTIFY_TELEGRAM=tg://bot_token/chat_id
    ```
 2. Inside the container: `touch ~/.claude/notify-on`
 
+See [configuration docs](docs/configuration.md#notifications-apprise) for all supported variables and URL formats.
+
 **To disable:** `rm ~/.claude/notify-on`
 
 **Events that trigger notifications:**
@@ -761,7 +773,7 @@ Walk away from your computer and know when Claude is done. Uses [Pushover](https
 | `stop` | Claude finished the current task |
 | `error` | A tool use failure occurred |
 
-> Completely silent when not configured. No tokens set? No flag file? Zero network calls. Zero log spam. Zero overhead.
+> Completely silent when not configured. No `NOTIFY_*` vars set? No flag file? Zero network calls. Zero log spam. Zero overhead.
 
 <p align="right">
   <a href="#top">↑ back to top</a>
@@ -784,7 +796,7 @@ Your data persists in `./data/claude` and `./workspace` — upgrading only repla
 To pin a specific version instead of `latest`:
 
 ```yaml
-image: CoderLuii/HolyClaude:1.0.0   # instead of :latest
+image: coderluii/holyclaude:1.1.0   # instead of :latest
 ```
 
 <p align="right">
@@ -877,7 +889,7 @@ These are not HolyClaude bugs — they're upstream issues or intentional trade-o
 | "Continue in Shell" button broken | CloudCLI upstream bug (race condition in terminal init) | Use the **Web Terminal** plugin instead (pre-installed) |
 | Cursor CLI "Command timeout" | No API key configured — cosmetic only, doesn't affect anything | Set `CURSOR_API_KEY` or ignore |
 | CloudCLI account lost on rebuild | SQLite can't persist on network mounts — intentional trade-off | Re-create account (~10 seconds) |
-| Web push notifications "not supported" | Browser limitation in CloudCLI, standard behavior | Use Pushover notifications instead |
+| Web push notifications "not supported" | Browser limitation in CloudCLI, standard behavior | Use Apprise notifications instead (see [Notifications](#bell-notifications)) |
 
 <p align="right">
   <a href="#top">↑ back to top</a>
@@ -903,7 +915,7 @@ docker build --build-arg VARIANT=slim -t holyclaude:slim .
 docker buildx build --platform linux/arm64 -t holyclaude .
 ```
 
-Then use `image: holyclaude` instead of `image: CoderLuii/HolyClaude:latest` in your compose file.
+Then use `image: holyclaude` instead of `image: coderluii/holyclaude:latest` in your compose file.
 
 <p align="right">
   <a href="#top">↑ back to top</a>
@@ -938,7 +950,8 @@ What's coming next:
 | Status | Feature |
 |--------|---------|
 | 🔜 | **ARM-native builds** — optimized native ARM64 images, not just emulated |
-| 🔜 | **Webhook notifications** — Discord, Slack, and custom webhook alerts alongside Pushover |
+| 🔜 | **VS Code tunnel integration** — built-in VS Code Server or tunnel for connecting from VS Code desktop |
+| 🔜 | **Notification routing** — different notification destinations per event type (errors to Telegram, completions to Discord) |
 
 Have an idea? [Start a discussion](https://github.com/CoderLuii/HolyClaude/discussions) or [request a feature](https://github.com/CoderLuii/HolyClaude/issues/new?template=feature_request.yml).
 

config/claude-memory-full.md

@@ -119,12 +119,12 @@ gh issue list
 gh pr merge
 ```
 
-## Notifications (Pushover)
+## Notifications (Apprise)
 
-Optional push notifications to your phone. Disabled by default.
+Optional push notifications via [Apprise](https://github.com/caronc/apprise) — supports 100+ services (Discord, Telegram, Slack, Email, Pushover, Gotify, and more). Disabled by default.
 
 **To enable:**
-1. Set `PUSHOVER_APP_TOKEN` and `PUSHOVER_USER_KEY` environment variables
+1. Set one or more `NOTIFY_*` environment variables (e.g. `NOTIFY_DISCORD`, `NOTIFY_TELEGRAM`, `NOTIFY_PUSHOVER`)
 2. Create the flag file: `touch ~/.claude/notify-on`
 
 **To disable:** `rm ~/.claude/notify-on`

config/claude-memory-slim.md

@@ -157,12 +157,12 @@ gh issue list
 gh pr merge
 ```
 
-## Notifications (Pushover)
+## Notifications (Apprise)
 
-Optional push notifications to your phone. Disabled by default.
+Optional push notifications via [Apprise](https://github.com/caronc/apprise) — supports 100+ services (Discord, Telegram, Slack, Email, Pushover, Gotify, and more). Disabled by default.
 
 **To enable:**
-1. Set `PUSHOVER_APP_TOKEN` and `PUSHOVER_USER_KEY` environment variables
+1. Set one or more `NOTIFY_*` environment variables (e.g. `NOTIFY_DISCORD`, `NOTIFY_TELEGRAM`, `NOTIFY_PUSHOVER`)
 2. Create the flag file: `touch ~/.claude/notify-on`
 
 **To disable:** `rm ~/.claude/notify-on`

config/settings.json

@@ -12,7 +12,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "/usr/local/bin/notify.sh stop"
+            "command": "/usr/local/bin/notify.py stop"
           }
         ]
       }
@@ -22,7 +22,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "/usr/local/bin/notify.sh error"
+            "command": "/usr/local/bin/notify.py error"
           }
         ]
       }

docker-compose.full.yaml

@@ -43,9 +43,14 @@ services:
       # - CHOKIDAR_USEPOLLING=1
       # - WATCHFILES_FORCE_POLLING=true
 
-      # --- Notifications (Pushover — optional) ---
-      # - PUSHOVER_APP_TOKEN=
-      # - PUSHOVER_USER_KEY=
+      # --- Notifications (uncomment services you want) ---
+      # - NOTIFY_DISCORD=discord://webhook_id/webhook_token
+      # - NOTIFY_TELEGRAM=tg://bot_token/chat_id
+      # - NOTIFY_PUSHOVER=pover://user_key@app_token
+      # - NOTIFY_SLACK=slack://token_a/token_b/token_c
+      # - NOTIFY_EMAIL=mailto://user:pass@gmail.com?to=you@gmail.com
+      # - NOTIFY_GOTIFY=gotify://hostname/token
+      # - NOTIFY_URLS=                                   # catch-all: comma-separated Apprise URLs
 
       # --- AI provider API keys (optional — can also set via web UI) ---
       # - GEMINI_API_KEY=

docs/CHANGELOG.md

@@ -4,6 +4,19 @@ All notable changes to HolyClaude will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/), and this project adheres to [Semantic Versioning](https://semver.org/).
 
-## [1.0.0] - 2026-03-21
+## [1.1.0] - 03/25/2026
+
+### Added
+- Apprise notification engine with support for 100+ services (Discord, Telegram, Slack, Email, Gotify, and more)
+- Individual `NOTIFY_*` environment variables for easy per-service configuration
+- Catch-all `NOTIFY_URLS` for any Apprise-supported service
+
+### Changed
+- Notification backend replaced from Pushover to Apprise
+
+### Removed
+- **BREAKING:** `PUSHOVER_APP_TOKEN` and `PUSHOVER_USER_KEY` environment variables removed. Migrate to `NOTIFY_PUSHOVER=pover://user_key@app_token`. See [configuration docs](configuration.md#notifications-apprise) for details.
+
+## [1.0.0] - 03/21/2026
 
 Initial public release.

docs/configuration.md

@@ -49,15 +49,24 @@ Only needed if your volumes are on a network share (Samba, NAS, etc.):
 | `CHOKIDAR_USEPOLLING` | (unset) | Set to `1` — enables polling for file watchers |
 | `WATCHFILES_FORCE_POLLING` | (unset) | Set to `true` — enables polling for Python watchers |
 
-### Notifications (Pushover)
+### Notifications (Apprise)
+
+HolyClaude uses [Apprise](https://github.com/caronc/apprise) for notifications, supporting 100+ services including Discord, Telegram, Slack, Email, Pushover, Gotify, and more.
 
 | Variable | Default | Description |
 |----------|---------|-------------|
-| `PUSHOVER_APP_TOKEN` | (unset) | Your Pushover application token |
-| `PUSHOVER_USER_KEY` | (unset) | Your Pushover user key |
+| `NOTIFY_DISCORD` | *(unset)* | Discord webhook — `discord://webhook_id/webhook_token` |
+| `NOTIFY_TELEGRAM` | *(unset)* | Telegram bot — `tg://bot_token/chat_id` |
+| `NOTIFY_PUSHOVER` | *(unset)* | Pushover — `pover://user_key@app_token` |
+| `NOTIFY_SLACK` | *(unset)* | Slack webhook — `slack://token_a/token_b/token_c` |
+| `NOTIFY_EMAIL` | *(unset)* | Email (SMTP) — `mailto://user:pass@gmail.com?to=you@gmail.com` |
+| `NOTIFY_GOTIFY` | *(unset)* | Gotify — `gotify://hostname/token` |
+| `NOTIFY_URLS` | *(unset)* | Catch-all — comma-separated [Apprise URLs](https://github.com/caronc/apprise/wiki) |
 
 Notifications also require the flag file `~/.claude/notify-on` to exist inside the container. Create it with `touch ~/.claude/notify-on`.
 
+**Migrating from Pushover (v1.0.0):** Replace `PUSHOVER_APP_TOKEN` and `PUSHOVER_USER_KEY` with a single variable: `NOTIFY_PUSHOVER=pover://user_key@app_token`
+
 ### AI Provider API Keys
 
 These can also be set through the CloudCLI web UI.

docs/dockerhub-description.md

@@ -78,6 +78,11 @@ Credentials stored locally in your bind-mounted `./data/claude` directory. We do
 | `PUID` | Container user UID | `1000` |
 | `PGID` | Container user GID | `1000` |
 | `CHOKIDAR_USEPOLLING` | Enable polling for NAS/SMB mounts | unset |
+| `NOTIFY_DISCORD` | Discord webhook URL for notifications | unset |
+| `NOTIFY_TELEGRAM` | Telegram bot URL for notifications | unset |
+| `NOTIFY_PUSHOVER` | Pushover URL for notifications | unset |
+| `NOTIFY_SLACK` | Slack webhook URL for notifications | unset |
+| `NOTIFY_URLS` | Catch-all Apprise notification URLs | unset |
 
 ## Volumes