Fix bridge connectivity, correct API auth, and add debug-status diagnostic#20
Open
sntxrr wants to merge 2 commits intongencokamin:mainfrom
Open
Fix bridge connectivity, correct API auth, and add debug-status diagnostic#20sntxrr wants to merge 2 commits intongencokamin:mainfrom
sntxrr wants to merge 2 commits intongencokamin:mainfrom
Conversation
- setup-tailscale-serve.sh: idempotent script that installs bbctl, configures Tailscale Serve (HTTPS → localhost:1234), saves config, and installs a LaunchAgent for auto-start + keep-alive on login - uninstall.sh: cleanly removes the LaunchAgent, Tailscale Serve config, and generated files - README: documents both setup paths (Tailscale Serve + legacy), useful commands, and generated file layout - .gitignore: exclude generated config.env and run-bridge.sh (contain secrets) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Key fixes: - bbctl run now passes BB_LOCAL_URL (localhost:1234) not TAILSCALE_URL — bridge and BlueBubbles both run on the same Mac so localhost is correct - BlueBubbles API auth uses ?password= query param, not Authorization header - bbctl download switched from GitHub releases to nightly.link zips (the releases endpoint no longer hosts binaries); clears Gatekeeper quarantine - Config save uses printf %q to safely handle special chars in password - Removed invalid `bbctl list` command from startup diagnostics (no such subcommand in bbctl v0.14+) - All setup-bb-beeper.sh name references corrected to setup-tailscale-serve.sh - uninstall-bb-beeper.sh reference corrected to uninstall.sh New: debug-status.sh — on-demand snapshot of all components (LaunchAgent, bridge processes, Beeper login, BlueBubbles API, Tailscale serve, config, log errors). Supports --log N and --errors flags. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
localhost:1234— fixedbbctl runto useBB_LOCAL_URL. Since the bridge and BlueBubbles run on the same Mac, localhost is always correct; the Tailscale Serve URL is for remote clients (phone/tablet) only.?password=as a query param, not anAuthorizationheader. Fixed in bothdebug-status.shand the runner's startup health check.xattr -d com.apple.quarantine).printf %qto safely shell-quote the password.bbctl listcommand — this subcommand doesn't exist in bbctl v0.14+, causing a logged error on every bridge startup.setup-bb-beeper.shname references throughout the script and README (file issetup-tailscale-serve.sh); fixeduninstall-bb-beeper.sh→uninstall.sh.New:
debug-status.shOn-demand diagnostic snapshot covering all components:
bbctlbinary + bridge process + mautrix-imessage processbbctl whoami(Beeper login + bridge list)?password=auth)Supports
--log N(print last N log lines) and--errors(ERR lines only).Test plan
bash setup-tailscale-serve.shfresh on an Apple Silicon Mac — verify bbctl downloads and installs without Gatekeeper promptbbctl runreceivesbluebubbles_url=http://localhost:1234bash debug-status.sh— all sections should show green, BlueBubbles API should return HTTP 200🤖 Generated with Claude Code