bbbbb

Setup

Agent execution contract

For coding agents

You are being asked to set up bbbbb HTTP alerts on this computer. Do not ask the user to choose HTTP versus CLI or to name the Source. Complete every safe step automatically, ask only for required host permission, and offer other setup paths only after the HTTP test succeeds.

  1. Outcome

    Prepare working HTTP alerts on this computer without installing the CLI.

  2. Do this now

    Read this complete page. Then download the audited bootstrap to a temporary file and run it. It reuses an existing approved HTTP Source when ready; otherwise it starts setup with a generic, non-confidential label.

    setup_file=$(mktemp "${TMPDIR:-/tmp}/bbbbb-setup.XXXXXX")
trap 'rm -f "$setup_file"' EXIT HUP INT TERM
curl --fail --silent --show-error --location https://bbbbb.app/setup/bootstrap.sh --output "$setup_file"
sh "$setup_file"
rm -f "$setup_file"
trap - EXIT HUP INT TERM

    The bootstrap pins the approved release origin and version, verifies the release archive checksum, resolves the current agent’s shared skill directory, and installs or updates only bbbbb-notify. It does not permanently install the CLI.

  3. Approve on iPhone

    Treat the temporary QR and six-digit fallback shown under Step 2 · Approve its code as one approval step, then wait for the iPhone approval.

  4. Success

    Do not print or paste the returned Source URL. The helper stores it in a supported private store, sends one setup test, and reports success only after the test is accepted.

  5. If blocked

    Ask only for the specific host permission or user action that prevents the next operation. Do not switch transports or improvise another installer. If storage fails after approval, tell the user to replace that Source in the app before retrying.

  6. After success

    Only after the HTTP test succeeds, ask: HTTP alerts are ready. Add the CLI command wrapper, connect another Source, or finish?

What happens

One approval. One private sender.

Your coding agent prepares the computer, then shows one temporary QR with a six-digit fallback. Open bbbbb on your iPhone, approve the code, review the generic Source label, and tap Add Source.

The permanent Source URL stays in private storage on the computer. It can send updates as that Source; it cannot read or control your inbox.

After the test succeeds

Optional expansion

01

CLI wrapper

Add the optional encrypted command wrapper for bbbbb run and exit-status reporting.

Open CLI guide
02

Another Source

Connect a separate HTTP Source for CI, a server, webhook, or service.

Connect another Source
03

Finish

Keep the default HTTP Source and stop. Nothing else is required for coding-agent alerts.

Get help