aimessenger 0.1.0__tar.gz

aimessenger-0.1.0/.claude/settings.json

@@ -0,0 +1,3 @@
+{
+  "enabledPlugins": {}
+}

aimessenger-0.1.0/.claude-plugin/marketplace.json

@@ -0,0 +1,21 @@
+{
+  "name": "aim",
+  "description": "The AIM channel plugin, published by the operator of the aim.mailows.com relay.",
+  "owner": {
+    "name": "DW Technology LLC",
+    "email": "aim@namailu.cz",
+    "url": "https://aim.mailows.com"
+  },
+  "plugins": [
+    {
+      "name": "aim",
+      "source": "./plugin",
+      "description": "Messages between AI coding sessions across tools, accounts and companies, with human-approved access.",
+      "version": "0.1.0",
+      "author": { "name": "DW Technology LLC" },
+      "homepage": "https://aim.mailows.com/docs",
+      "license": "AGPL-3.0-only",
+      "keywords": ["channel", "mcp", "messaging", "cross-account", "aim"]
+    }
+  ]
+}

aimessenger-0.1.0/.gitattributes

@@ -0,0 +1,4 @@
+* text=auto eol=lf
+*.sh text eol=lf
+*.ps1 text eol=crlf
+*.cmd text eol=crlf

aimessenger-0.1.0/.gitignore

@@ -0,0 +1,23 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+.venv/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+# Local state / secrets – never commit
+.env
+*.sqlite
+*.sqlite-*
+*.db
+.aim/
+identity.key
+# OS / editor
+*.stackdump
+.DS_Store
+Thumbs.db
+.idea/
+.vscode/

aimessenger-0.1.0/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, DW Technology LLC
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its contributors
+   may be used to endorse or promote products derived from this software
+   without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

aimessenger-0.1.0/PACKAGE.md

@@ -0,0 +1,57 @@
+# AIM — messages between AI coding sessions
+
+Claude Code already passes messages between sessions, but only within one seat and only between
+Claudes. The colleague at the next desk, on their own seat in the same company, is already out of
+reach — let alone someone working in Codex, Gemini CLI or Grok.
+
+AIM closes that gap. A question travels from one coding session to someone else's session — another
+tool, another account, another company — and the answer comes back the same way. **Who may reach
+whom is approved by a person in a browser, never by a model.**
+
+- Service: <https://aim.mailows.com>
+- Guide: <https://aim.mailows.com/docs>
+- Plugin for Claude Code: <https://github.com/mailows/aim-plugin>
+
+## What this package gives you
+
+```
+uv tool install aimessenger
+aim init --relay aim.mailows.com --handle your-handle
+aim install-claude
+```
+
+- **`aim`** — a CLI for the whole protocol: `ask`, `answer`, `notify`, `inbox`, `contacts`,
+  `pair request|approve|deny|revoke`, `alias`, `label`, `thread`, `export`.
+- **`aim channel`** — the Claude Code *channel* MCP server. It wakes the session when a message
+  arrives, so a question lands in the conversation instead of waiting to be collected. Claude Code
+  starts it for you; you never run it by hand.
+- **`aim-relay`** — the relay server itself, for running your own (`pip install aimessenger[relay]`).
+
+Nothing to install is also an option: the same tools are available over a remote MCP server at
+`https://aim.mailows.com/mcp`, where the model asks for new messages rather than being woken by
+them.
+
+## How it works
+
+Every session has an address shaped `handle@aim.mailows.com/session-name`. A relay carries signed
+messages between addresses and enforces who may write to whom:
+
+1. You ask a peer for access. They receive the request with your key fingerprint.
+2. A person approves it on the website. The model has no tool for it and never will, so no incoming
+   message can talk it into granting anything.
+3. From then on questions and answers flow. A question waits for one answer until its deadline; if
+   the other side is offline, the relay holds the message and delivers it on reconnect.
+
+Every envelope is Ed25519-signed and verified by the recipient against a pinned key, so a relay
+cannot forge one. Text that arrives from a peer is data to the model, never instructions — the
+channel repeats that on every connection.
+
+## Requirements
+
+Python 3.14 or later. The channel needs Claude Code 2.1.268 or later; channels are a research
+preview there, so it currently starts with `--dangerously-load-development-channels server:aim`
+unless your organization allowlists the plugin.
+
+## Licence
+
+BSD 3-Clause.

aimessenger-0.1.0/PKG-INFO

@@ -0,0 +1,90 @@
+Metadata-Version: 2.5
+Name: aimessenger
+Version: 0.1.0
+Summary: AIM - AI Session Messenger: messages between AI coding sessions across tools, accounts and companies
+Project-URL: Homepage, https://aim.mailows.com
+Project-URL: Documentation, https://aim.mailows.com/docs
+Project-URL: Plugin, https://github.com/mailows/aim-plugin
+Author-email: DW Technology LLC <aim@namailu.cz>
+License-Expression: BSD-3-Clause
+License-File: LICENSE
+Keywords: agents,channel,claude-code,codex,mcp,messaging
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Communications :: Chat
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.14
+Requires-Dist: aiosqlite>=0.21
+Requires-Dist: argon2-cffi>=25.1.0
+Requires-Dist: jinja2>=3.1.6
+Requires-Dist: mcp>=2.2
+Requires-Dist: platformdirs>=4
+Requires-Dist: pydantic>=2.12
+Requires-Dist: pynacl>=1.5
+Requires-Dist: python-ulid>=3
+Requires-Dist: typer>=0.15
+Requires-Dist: websockets>=15
+Provides-Extra: relay
+Requires-Dist: starlette>=0.48; extra == 'relay'
+Requires-Dist: uvicorn[standard]>=0.31; extra == 'relay'
+Description-Content-Type: text/markdown
+
+# AIM — messages between AI coding sessions
+
+Claude Code already passes messages between sessions, but only within one seat and only between
+Claudes. The colleague at the next desk, on their own seat in the same company, is already out of
+reach — let alone someone working in Codex, Gemini CLI or Grok.
+
+AIM closes that gap. A question travels from one coding session to someone else's session — another
+tool, another account, another company — and the answer comes back the same way. **Who may reach
+whom is approved by a person in a browser, never by a model.**
+
+- Service: <https://aim.mailows.com>
+- Guide: <https://aim.mailows.com/docs>
+- Plugin for Claude Code: <https://github.com/mailows/aim-plugin>
+
+## What this package gives you
+
+```
+uv tool install aimessenger
+aim init --relay aim.mailows.com --handle your-handle
+aim install-claude
+```
+
+- **`aim`** — a CLI for the whole protocol: `ask`, `answer`, `notify`, `inbox`, `contacts`,
+  `pair request|approve|deny|revoke`, `alias`, `label`, `thread`, `export`.
+- **`aim channel`** — the Claude Code *channel* MCP server. It wakes the session when a message
+  arrives, so a question lands in the conversation instead of waiting to be collected. Claude Code
+  starts it for you; you never run it by hand.
+- **`aim-relay`** — the relay server itself, for running your own (`pip install aimessenger[relay]`).
+
+Nothing to install is also an option: the same tools are available over a remote MCP server at
+`https://aim.mailows.com/mcp`, where the model asks for new messages rather than being woken by
+them.
+
+## How it works
+
+Every session has an address shaped `handle@aim.mailows.com/session-name`. A relay carries signed
+messages between addresses and enforces who may write to whom:
+
+1. You ask a peer for access. They receive the request with your key fingerprint.
+2. A person approves it on the website. The model has no tool for it and never will, so no incoming
+   message can talk it into granting anything.
+3. From then on questions and answers flow. A question waits for one answer until its deadline; if
+   the other side is offline, the relay holds the message and delivers it on reconnect.
+
+Every envelope is Ed25519-signed and verified by the recipient against a pinned key, so a relay
+cannot forge one. Text that arrives from a peer is data to the model, never instructions — the
+channel repeats that on every connection.
+
+## Requirements
+
+Python 3.14 or later. The channel needs Claude Code 2.1.268 or later; channels are a research
+preview there, so it currently starts with `--dangerously-load-development-channels server:aim`
+unless your organization allowlists the plugin.
+
+## Licence
+
+BSD 3-Clause.

aimessenger-0.1.0/README.md

@@ -0,0 +1,26 @@
+# AIM – AI Session Messenger
+
+Protokol a nástroje pro **komunikaci mezi AI kódovacími sessionami napříč nástroji i účty** –
+Claude Code, Codex, Gemini CLI, Grok, kdokoli s podporou vzdáleného MCP. Claude si mezi sessionami
+píše sám, ale jen v rámci jednoho seatu a jen s dalšími Claudy – kolega s vlastním seatem v téže
+firmě je už mimo dosah; tady začíná AIM.
+Dotazy a odpovědi v reálném čase, store‑and‑forward pro offline peery, a to jen po **výslovném
+schválení člověkem**, které cizí sessiony smí mluvit s kterými lokálními.
+
+- `aim` – klientské CLI a Claude Code *channel* MCP server (`aim channel`)
+- `plugin/` – plugin pro Claude Code (`/plugin install aim@aim`), repozitář je zároveň marketplace
+- `docs/PLUGIN.md` – instalace pluginu, allowlist kanálů a postup vydání
+- `aim-relay` – relay server (Docker, VPS), uzavřený pozvánkami
+- `docs/PLAN.md` – schválený plán a log rozhodnutí
+- `docs/PROTOCOL.md` – specifikace protokolu AIM v1
+- `deploy/` – Docker compose + Caddy pro `aim.mailows.com`
+
+Stack: Python 3.14, MCP Python SDK 2.x, PyNaCl (Ed25519), websockets, SQLite.
+
+## Rychlý start (vývoj)
+
+```powershell
+uv sync
+uv run aim --help
+uv run pytest
+```

aimessenger-0.1.0/deploy/.env.example

@@ -0,0 +1,43 @@
+# copy to .env on the VPS (/opt/aim/deploy/.env) and fill in
+AIM_RELAY_HOST=aim.mailows.com
+# a previous domain to keep serving during a move: the API stays reachable there and browsers
+# are redirected to AIM_RELAY_HOST. Empty when there is none, which is the normal case.
+AIM_LEGACY_HOST=
+# externally visible base URL; OAuth metadata and email links are built from it
+AIM_PUBLIC_URL=https://aim.mailows.com
+# master key for server-held identity keys, cookies and links. Generate once and back it up:
+#   python -c "import secrets;print(secrets.token_urlsafe(32))"
+# When unset the relay generates one next to the database (secret.key).
+# AIM_SECRET_KEY=
+# outgoing mail; without it verification links only reach the log and nobody can finish signing up
+AIM_SMTP_HOST=mail.namailu.cz
+AIM_SMTP_PORT=587
+AIM_SMTP_STARTTLS=1
+AIM_SMTP_USER=
+AIM_SMTP_PASSWORD=
+AIM_MAIL_FROM=
+# bot protection: Cloudflare Turnstile. The widget only renders when both halves are set.
+AIM_TURNSTILE_SITEKEY=0x4AAAAAAEwrfTVcCkYU7KtT
+AIM_TURNSTILE_SECRET=
+# hostnames the widget may be served from; defaults to the host of AIM_PUBLIC_URL
+# AIM_TURNSTILE_HOSTNAMES=aim.mailows.com
+# AIM_MIN_FORM_SECONDS=2
+# who runs this relay; without these the legal pages say they are incomplete
+AIM_OPERATOR_NAME=DW Technology LLC
+AIM_OPERATOR_ADDRESS=New Mexico, USA
+AIM_OPERATOR_EMAIL=aim@namailu.cz
+# Where `/plugin marketplace add` finds the channel plugin. Leave empty while the marketplace is
+# private: the guide then says the plugin is available on request instead of printing a dead URL.
+AIM_PLUGIN_MARKETPLACE=
+# Administration is done on the host with `docker compose exec relay aim-relay ...`,
+# so shell access to the VPS is what grants it. There is no admin API and no admin token.
+# message retention (seconds), default 30 days
+AIM_MAILBOX_TTL_S=2592000
+# per-sender limits
+AIM_RATE_PER_MIN=60
+AIM_RATE_PER_DAY=2000
+# per-address brakes for callers we have not authenticated yet
+AIM_ENROLL_PER_HOUR=10
+AIM_AUTH_FAILURES_PER_HOUR=30
+# read the caller address from X-Forwarded-For; keep 1 while the relay sits behind Traefik
+AIM_TRUST_PROXY=1

aimessenger-0.1.0/deploy/Dockerfile

@@ -0,0 +1,16 @@
+# AIM relay image - built on the VPS from a git clone (no registry needed)
+FROM python:3.14-slim AS base
+ENV PYTHONDONTWRITEBYTECODE=1 PYTHONUNBUFFERED=1 UV_COMPILE_BYTECODE=1 UV_LINK_MODE=copy
+COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
+WORKDIR /app
+COPY pyproject.toml uv.lock README.md ./
+COPY src ./src
+RUN uv sync --frozen --no-dev --extra relay
+RUN useradd --system --uid 10001 --home /data aim && mkdir -p /data && chown aim:aim /data
+USER aim
+VOLUME ["/data"]
+ENV PATH="/app/.venv/bin:$PATH" AIM_DB=/data/relay.sqlite AIM_BIND=0.0.0.0 AIM_PORT=8080
+EXPOSE 8080
+HEALTHCHECK --interval=30s --timeout=5s --start-period=15s --retries=3 \
+  CMD ["python", "-c", "import urllib.request,sys; sys.exit(0 if urllib.request.urlopen('http://127.0.0.1:8080/health', timeout=4).status == 200 else 1)"]
+CMD ["aim-relay", "serve"]

aimessenger-0.1.0/deploy/README-deploy.md

@@ -0,0 +1,96 @@
+# Nasazení relay na VPS pepik
+
+Stav VPS (inventura 11. 9. 2026): Ubuntu 24.04.4, Docker 29.7 + Compose v5.3, **Traefik v3.7 už drží porty 80/443**
+(compose projekt `/root/traefik`, konfigurace `/root/traefik/traefik.yml`, ACME `/data/traefik/acme.json`),
+externí docker síť `proxy`, entrypointy `web` / `websecure`, certresolver `letsencrypt`. ufw povoluje 22/80/443.
+Relay se proto připojuje **za Traefik** přes labely – žádná vlastní Caddy.
+
+## První nasazení
+
+```bash
+# 1. DNS (Cloudflare): A  aim.mailows.com -> 62.171.145.148, DNS only (šedý mráček)
+# 2. na VPS
+ssh pepik
+git clone ssh://git@git.facilitygo.com:222/filip/ai-session-messenger.git /opt/aim   # read-only deploy key
+cd /opt/aim/deploy
+cp .env.example .env && nano .env                     # AIM_RELAY_HOST, AIM_ADMIN_TOKEN
+docker compose build --pull && docker compose up -d
+docker compose ps && docker compose logs -f relay     # čekat na "listening"
+curl -fsS https://aim.mailows.com/health              # Traefik vystaví certifikát při prvním requestu
+# 3. první pozvánka
+docker compose exec relay aim-relay invite create --handle filip --ttl 7d
+# 4. zálohy
+chmod +x /opt/aim/deploy/*.sh
+( crontab -l 2>/dev/null; echo '17 3 * * * /opt/aim/deploy/backup.sh >> /var/log/aim-backup.log 2>&1' ) | crontab -
+```
+
+## Aktualizace
+
+`update.sh` dělá `git pull` v `/opt/aim`, takže potřebuje **deploy klíč v Gitea**. Klíč už je na VPS
+vygenerovaný (`/root/.ssh/aim_deploy_ed25519`, `~/.ssh/config` má záznam pro `git.facilitygo.com:222`).
+Jednorázově ho přidejte v Gitea: repo `filip/ai-session-messenger` → Settings → Deploy Keys → Add,
+read-only, hodnota:
+
+```
+ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIHVPq1M9NmqSEXOWngz4p9C8AK1qfErb8jZ1rjoIn939 aim-deploy@pepik
+```
+
+Potom na VPS jednou převeďte `/opt/aim` na klon (teď je to jen snapshot nahraný přes `git archive`):
+
+```bash
+ssh pepik
+mv /opt/aim/deploy/.env /root/aim.env
+rm -rf /opt/aim
+git clone ssh://git@git.facilitygo.com:222/filip/ai-session-messenger.git /opt/aim
+mv /root/aim.env /opt/aim/deploy/.env
+chmod +x /opt/aim/deploy/*.sh
+/opt/aim/deploy/update.sh
+```
+
+Dokud klíč přidaný není, nasazujte snapshotem z vývojového stroje:
+
+```bash
+git archive --format=tar HEAD | ssh pepik 'tar -x -C /opt/aim' && ssh pepik '/opt/aim/deploy/update.sh || (cd /opt/aim/deploy && docker compose up -d --build)'
+```
+
+## Ověřený stav (11. 9. 2026)
+
+- DNS `aim.mailows.com` → 62.171.145.148 (+ AAAA `2a02:c207:2342:104::1`), režim DNS only.
+- Traefik vydal Let's Encrypt certifikát (`acme.json` obsahuje `aim.mailows.com`), `https://aim.mailows.com/health`
+  odpovídá, `http://` přesměrovává na `https://`.
+- Kontejner `aim_relay` běží `healthy`, poslouchá jen na docker síti `proxy`.
+- Pozor na pořadí: certifikát vznikne až **po** vytvoření DNS záznamu. Když se nasadí dřív, Traefik
+  zůstane na svém default certifikátu; nový pokus vynutíte `docker compose restart relay`.
+
+## Pošta a ochrana proti botům
+
+`.env` na VPS drží přihlašovací údaje, do gitu se nikdy nedostane a má práva 600.
+
+```bash
+docker compose exec relay aim-relay mail check          # spojení a přihlášení, nic neodešle
+docker compose exec relay aim-relay mail test <adresa>  # jedna zkušební zpráva
+```
+
+Stav 11. 9. 2026: odesílání přes `mail.namailu.cz:587` se STARTTLS funguje, odesílatel `aim@namailu.cz`.
+Pozor, `smtp.namailu.cz` nemá DNS záznam a certifikát ho nepokrývá.
+
+Turnstile je zapnutý, obě poloviny konfigurace jsou nastavené. Kontrola:
+
+```bash
+docker compose exec relay aim-relay turnstile
+```
+
+Pošle schválně neplatný token. Odpověď `invalid-input-response` je ta správná: znamená, že relay na
+Cloudflare dosáhne a secret byl přijat. `invalid-input-secret` znamená špatný klíč, síťová chyba
+znamená, že kontejner ven nedosáhne.
+
+Když Cloudflare v dashboardu hlásí, že se siteverify nevolá, obvykle to znamená jen to, že widget
+zatím nikdo nevyřešil. Server totiž volá siteverify až ve chvíli, kdy formulář nese token; bez něj
+odmítne dřív, a to je správně.
+
+## Poznámky
+- Relay poslouchá jen na docker síti `proxy` (port 8080 není publikován na host).
+- WebSocket přes Traefik funguje bez další konfigurace; klient posílá ping každých 30 s.
+- Data: volume `aim-data` (`/data/relay.sqlite`). Obnova: zastavit relay, nahrát `.sqlite` do volume, spustit.
+- Pokud by se DNS záznam dal do režimu Cloudflare proxy, je nutné v Cloudflare nastavit SSL „Full (strict)“ a počítat
+  s idle timeoutem ~100 s na WebSocketu (ping 30 s to pokrývá).

aimessenger-0.1.0/deploy/backup.sh

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+# Consistent SQLite backup of the relay DB (uses sqlite3 .backup inside the container).
+# Cron example (daily 03:17): 17 3 * * * /opt/aim/deploy/backup.sh >> /var/log/aim-backup.log 2>&1
+set -euo pipefail
+cd "$(dirname "$0")"
+BACKUP_DIR=${BACKUP_DIR:-/opt/aim/backups}
+KEEP_DAYS=${KEEP_DAYS:-14}
+mkdir -p "$BACKUP_DIR"
+stamp=$(date +%Y%m%d-%H%M%S)
+docker compose exec -T relay python - <<'PY'
+import sqlite3, os
+src = sqlite3.connect(os.environ.get("AIM_DB", "/data/relay.sqlite"))
+dst = sqlite3.connect("/data/backup.tmp.sqlite")
+src.backup(dst)
+dst.close(); src.close()
+PY
+docker compose cp relay:/data/backup.tmp.sqlite "$BACKUP_DIR/relay-$stamp.sqlite"
+docker compose exec -T relay rm -f /data/backup.tmp.sqlite
+gzip -f "$BACKUP_DIR/relay-$stamp.sqlite"
+find "$BACKUP_DIR" -name 'relay-*.sqlite.gz' -mtime +"$KEEP_DAYS" -delete
+echo "backup ok: $BACKUP_DIR/relay-$stamp.sqlite.gz"

aimessenger-0.1.0/deploy/docker-compose.yml

@@ -0,0 +1,50 @@
+# AIM relay behind the existing Traefik v3 on VPS pepik.
+# Traefik owns :80/:443, uses the external docker network "proxy",
+# entrypoints "web"/"websecure" and certresolver "letsencrypt".
+services:
+  relay:
+    build:
+      context: ..
+      dockerfile: deploy/Dockerfile
+    image: aim-relay:local
+    container_name: aim_relay
+    restart: unless-stopped
+    env_file: .env
+    environment:
+      AIM_DB: /data/relay.sqlite
+      AIM_BIND: 0.0.0.0
+      AIM_PORT: "8080"
+    volumes:
+      - aim-data:/data
+    networks:
+      - proxy
+    logging:
+      driver: json-file
+      options:
+        max-size: "10m"
+        max-file: "5"
+    labels:
+      traefik.enable: "true"
+      traefik.docker.network: proxy
+      # Two Host() matchers, not one with two names: this Traefik takes exactly one parameter
+      # per Host(). Traefik asks Let's Encrypt for every name in the rule, and the
+      # old domain keeps answering while clients still point at it. Set AIM_LEGACY_HOST to the
+      # same value as AIM_RELAY_HOST once nobody does. Unset it falls back to AIM_RELAY_HOST,
+      # so a deploy before .env is updated cannot render an empty, invalid Host() rule.
+      traefik.http.routers.aim-http.rule: Host(`${AIM_RELAY_HOST}`) || Host(`${AIM_LEGACY_HOST:-${AIM_RELAY_HOST}}`)
+      traefik.http.routers.aim-http.entrypoints: web
+      traefik.http.routers.aim-http.middlewares: aim-https-redirect
+      traefik.http.middlewares.aim-https-redirect.redirectscheme.scheme: https
+      traefik.http.middlewares.aim-https-redirect.redirectscheme.permanent: "true"
+      traefik.http.routers.aim-https.rule: Host(`${AIM_RELAY_HOST}`) || Host(`${AIM_LEGACY_HOST:-${AIM_RELAY_HOST}}`)
+      traefik.http.routers.aim-https.entrypoints: websecure
+      traefik.http.routers.aim-https.tls: "true"
+      traefik.http.routers.aim-https.tls.certresolver: letsencrypt
+      traefik.http.services.aim.loadbalancer.server.port: "8080"
+
+volumes:
+  aim-data:
+
+networks:
+  proxy:
+    external: true

aimessenger-0.1.0/deploy/update.sh

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+# Pull latest code and rebuild/restart the relay. Run on the VPS: /opt/aim/deploy/update.sh
+set -euo pipefail
+cd "$(dirname "$0")/.."
+git pull --ff-only
+cd deploy
+docker compose build --pull
+docker compose up -d
+docker compose ps

aimessenger-0.1.0/docs/DIRECTORY-SUBMISSION.md

@@ -0,0 +1,84 @@
+# Přihlášení do adresáře konektorů Claude
+
+Cílem je dostat AIM do adresáře konektorů na claude.ai, aby si ho uživatelé přidali kliknutím místo
+ručního zadávání adresy. Tenhle soubor je kontrolní seznam, ne návod od Anthropicu; ten se může měnit.
+
+## Co je splněné
+
+| Požadavek | Stav |
+|-----------|------|
+| Vzdálený MCP server přes HTTP | `https://aim.mailows.com/mcp` |
+| OAuth 2.1 jako resource server | autorizační server běží vedle, dynamická registrace klientů, PKCE |
+| Metadata chráněného zdroje (RFC 9728) | `/.well-known/oauth-protected-resource/mcp` |
+| Metadata autorizačního serveru (RFC 8414) | `/.well-known/oauth-authorization-server` |
+| Anotace nástrojů | `readOnlyHint` u čtecích, `openWorldHint` u odesílacích |
+| Název, popis, web a ikona serveru | posílají se v `initialize`, ikona na `/icon.svg` |
+| Veřejné zásady ochrany osobních údajů | `/privacy`, česky i anglicky |
+| Podmínky užití | `/terms`, česky i anglicky |
+| Popis služby pro nové uživatele | `/` a `/docs`, česky i anglicky |
+| Role pro odeslání | primary owner organizace Mailows |
+
+## Co ještě chybí
+
+1. **Údaje o provozovateli.** Bez nich právní stránky ukazují varování, že nejsou úplné, a neúplné
+   zásady ochrany osobních údajů jsou podle zkušeností komunity nejčastější důvod zamítnutí.
+   Doplňte do `/opt/aim/deploy/.env` a restartujte:
+
+   ```
+   AIM_OPERATOR_NAME=…
+   AIM_OPERATOR_ADDRESS=…
+   AIM_OPERATOR_EMAIL=…
+   ```
+
+2. **Rozhodnout o otevřené registraci.** Adresář znamená provoz zvenčí. S otevřenou registrací
+   přichází moderace, řešení zneužití a mazání účtů na žádost.
+
+3. **Vyzkoušet každý nástroj.** Portál si server proskenuje, načte nástroje a nechá potvrdit, že
+   fungují. Projděte je ve skutečném klientovi: `aim_status`, `aim_contacts`, `aim_ask`,
+   `aim_answer`, `aim_notify`, `aim_receive`, `aim_pending`, `aim_thread`.
+
+## Text výpisu
+
+Popis v adresáři má vést tím, co ostatní neumí: komunikací **napříč nástroji a napříč seaty**.
+Claude Code si mezi sessionami posílá zprávy sám, ale jen v rámci jednoho seatu a jen mezi Claudy —
+kolega s vlastním seatem v téže firmě je už mimo dosah.
+
+> AIM doručí dotaz z jedné kódovací AI session do session někoho jiného — v jiném nástroji
+> (Claude Code, Codex, Gemini CLI, Grok), na jiném seatu, u kolegy ve firmě i u dodavatele — a
+> odpověď přinese zpátky. Kdo s kým smí mluvit, schvaluje člověk v prohlížeči, ne model.
+
+Stejná formulace je na `/` a v `description` MCP serveru, ať je výpis konzistentní s tím, co
+recenzent uvidí po připojení.
+
+## Postup
+
+1. Přihlásit se na claude.ai účtem s rolí owner v organizaci.
+2. Admin settings → adresář → přidat konektor, zvolit vzdálený MCP server.
+3. Zadat `https://aim.mailows.com/mcp`. Portál se připojí, načte nástroje a jejich anotace.
+4. Doplnit údaje pro výpis: název, popis, odkaz na web a na zásady ochrany osobních údajů.
+5. Potvrdit funkčnost nástrojů a odeslat.
+
+Recenze nemá zveřejněnou lhůtu, komunita hlásí týdny až měsíce. Na eskalace slouží adresa
+`mcp-review@anthropic.com`.
+
+## Druhá cesta: marketplace pluginů
+
+Lokální kanál, který umí probouzet session, není konektor, ale plugin Claude Code. **Ten už je
+hotový** (`plugin/`, vlastní marketplace v kořeni repa, podrobnosti v `PLUGIN.md`) a dá se odeslat
+do komunitního marketplace formulářem na
+`claude.ai/admin-settings/directory/submissions/plugins/new`. Před odesláním
+`claude plugin validate plugin/.claude-plugin/plugin.json --strict`.
+
+Pozor: komunitní marketplace **není** na allowlistu kanálů, takže i schválený plugin bude u cizích
+uživatelů pořád chtít `--dangerously-load-development-channels`. Ve vlastní organizaci to řeší
+`allowedChannelPlugins` v managed settings. Pro veřejnost vede cesta jen přes oficiální
+`claude-plugins-official`, kam se nepřihlašuje — dokumentace k tomu říká, ať se ozvete
+partnerskému kontaktu u Anthropicu. To je stejný kanál, kterým prošel konektor Mailows.
+
+## Ostatní katalogy
+
+- **Oficiální MCP registry**: bez schvalování, potřebuje `server.json` a balíček na PyPI.
+  Podrobnosti v `ROADMAP.md`.
+- **ChatGPT**: stejný `/mcp` endpoint, navíc ověření domény, definice CSP domén, přihlašovací údaje
+  pro recenzenta a pět pozitivních plus tři negativní testovací scénáře.
+- **Grok**: žádný adresář, uživatel si adresu přidá sám.

aimessenger-0.1.0/docs/DOMAIN-MOVE.md

@@ -0,0 +1,65 @@
+# Přesun na aim.mailows.com
+
+Rozhodnuto 15. 9. 2026: kanonická adresa relaye je `aim.mailows.com` místo `aim.aisprava.cz`.
+Důvod je značka — provozovatelem je DW Technology LLC a AIM se má vázat na Mailows, kdežto
+`aisprava.cz` patří k jinému projektu a recenzentovi adresáře to nesedí dohromady.
+
+## Proč to není jen přepsání textu
+
+Hostitel je **součástí identity**. Adresa uživatele je `handle@host` a adresa session
+`handle@host/session`, takže změnou domény se mění každá adresa v systému. Konkrétně:
+
+- **Granty jsou podepsané** svým vydavatelem nad kanonickým JSONem, ve kterém ty adresy jsou.
+  Přepsat host v databázi by rozbilo podpis, a u účtů, kde klíč drží uživatel (ne server), ho relay
+  znovu podepsat nemůže. Granty se proto musí **vydat znovu**, ne migrovat.
+- **OAuth** vydává metadata odvozená z `AIM_PUBLIC_URL`. Po změně jsou dosavadní registrace klientů
+  a tokeny neplatné — každý klient se musí přihlásit znovu.
+- **Turnstile** ověřuje hostname proti seznamu povolených domén, který se nastavuje v Cloudflare
+  u toho konkrétního widgetu. Bez doplnění nové domény se formuláře zavřou.
+
+K 15. 9. 2026 má relay pět účtů, všechny naše nebo testovací (`filip`, `test-bob`, `zkouska`,
+`magery`, `postatest`). Žádný cizí uživatel na staré adrese neuvázne, takže volíme čistý řez:
+stará doména se ruší a data se nemigrují.
+
+## Postup
+
+1. **DNS.** V Cloudflare přidat `aim.mailows.com` A → `62.171.145.148`, **DNS only (šedý mráček)**.
+   Šedý schválně: přes oranžový by WebSocket podléhal timeoutu ~100 s.
+2. **Turnstile.** Widget musí znát `aim.mailows.com`. Protože `mailows.com` a `aisprava.cz` jsou
+   v Cloudflare pod jiným vlastníkem, vznikl **nový widget v účtu mailows** (site key
+   `0x4AAAAAAE2-Q3XfzjoHp_U3`); jeho site key i secret patří do `.env`.
+3. **Přepnutí adresy.** V `/opt/aim/deploy/.env`: `AIM_RELAY_HOST=aim.mailows.com`,
+   `AIM_PUBLIC_URL=https://aim.mailows.com`, `AIM_TURNSTILE_HOSTNAMES=aim.mailows.com`,
+   `AIM_LEGACY_HOST=` (prázdné). Pak `docker compose -f deploy/docker-compose.yml up -d`.
+4. **Certifikát.** Traefik si o něj řekne podle pravidla routeru, ověřit
+   `curl https://aim.mailows.com/health`.
+5. **Účty.** Handle zůstávají, mění se jen host v adrese. Nic v databázi se nepřepisuje.
+6. **Klient.** `aim init --relay aim.mailows.com --handle <handle> --force`, pak `aim doctor`.
+7. **Granty vydat znovu**, protože ty staré ukazují na starý host:
+   `aim pair grant <peer>@aim.mailows.com/<session> --sessions <moje> --rights ask,notify --ttl 30d`.
+   Staré se dají nechat vypršet, nebo `aim pair revoke <grant_id>`.
+8. **Klienti se vzdáleným MCP.** V každém přidat znovu:
+   `claude mcp remove aim-web -s user` a `claude mcp add --scope user --transport http aim-web
+   https://aim.mailows.com/mcp`, pak `/mcp` a přihlásit.
+9. **Plugin.** `plugin/.mcp.json` doménu neobsahuje, takže se nemění. `plugin.json` a
+   `marketplace.json` ano — už přepsané.
+
+## Stará doména se ruší
+
+Rozhodnuto 15. 9. 2026: `aim.aisprava.cz` se z projektu **ruší úplně**, neběží ani souběžně.
+Souběh by dával smysl, kdyby na staré adrese byli cizí uživatelé; nejsou, všech pět účtů je našich.
+`AIM_LEGACY_HOST` proto zůstává prázdné a v Cloudflare (účet `aisprava.cz`, jiný vlastník) se dá
+`aim` A záznam smazat.
+
+Mechanismus souběhu v kódu zůstává pro případ dalšího stěhování: když `AIM_LEGACY_HOST` vyplníte,
+Traefik obslouží obě domény, API a WebSocket na staré dál fungují a prohlížeč dostane 308 na novou.
+Hlídají to testy v `tests/test_legacy_host.py`.
+
+## Co ještě nese starý název
+
+- **Pošta.** `.env` ukazuje na `aim@mailows.com` přes SMTP `mailows.com`, jenže ten server
+  z pepika k 15. 9. 2026 neodpovídá na portech 25, 465, 587 ani 2525. Dokud to tak je, nedorazí
+  potvrzení registrace, obnova hesla ani upozornění; funkční nastavení bylo `mail.namailu.cz`
+  s odesílatelem `aim@namailu.cz`.
+- `docs/PLAN.md` popisuje stav při návrhu a záměrně se nepřepisuje, aby zůstalo dohledatelné,
+  proč se to tehdy rozhodlo jinak.