diff --git a/CLAUDE.md b/CLAUDE.md index 61e33dc..b365349 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -91,9 +91,14 @@ ssh admin.yttrx.com 'docker exec yttrx-welcomebot python -c \ ### Viewing logs -A `welcomebot-logs` CLI is installed at `/usr/local/bin/welcomebot-logs` on -admin.yttrx.com (source: `bin/welcomebot-logs` in this repo). It wraps -`docker logs` for the container: +A `welcomebot-logs` CLI lives at `/root/bin/welcomebot-logs` on admin.yttrx.com +(source: `bin/welcomebot-logs` in this repo) — `/root/bin` is the homelab's +standard location for root-owned admin scripts (same convention as `bsd`'s +`peteftw-analytics` and the NAS backup scripts). A symlink at +`/usr/local/bin/welcomebot-logs` makes the bare command work over +non-interactive `ssh admin.yttrx.com welcomebot-logs`, since that doesn't +source `~/.bashrc` and so wouldn't otherwise see `/root/bin` on `PATH`. It +wraps `docker logs` for the container: ```bash ssh admin.yttrx.com welcomebot-logs # last 200 lines @@ -105,10 +110,10 @@ ssh admin.yttrx.com 'welcomebot-logs --help' ### Inspecting signup-IP classification history -`welcomebot-signups` (also `/usr/local/bin/welcomebot-signups`, source -`bin/welcomebot-signups`) reads the persistent `signup_ip` sqlite table -directly — a permanent record of every classification decision, independent -of log retention: +`welcomebot-signups` (`/root/bin/welcomebot-signups`, symlinked from +`/usr/local/bin` same as above; source `bin/welcomebot-signups`) reads the +persistent `signup_ip` sqlite table directly — a permanent record of every +classification decision, independent of log retention: ```bash ssh admin.yttrx.com welcomebot-signups # last 20 decisions @@ -122,7 +127,9 @@ reinstall with: ```bash ssh admin.yttrx.com 'cd /root/yttrx-welcomebot && git pull origin main && \ - install -m755 bin/welcomebot-logs bin/welcomebot-signups /usr/local/bin/' + install -m755 bin/welcomebot-logs bin/welcomebot-signups /root/bin/' +# /usr/local/bin/welcomebot-{logs,signups} are symlinks to /root/bin — no +# need to touch them again once created. ``` ### Rollback