Skip to main content

Install Relaybraid

Install the relaybraid CLI (into ~/.local/bin; it only talks to this host). For scripts and coding agents, use the relaybraid CLI or the Node SDK rather than raw HTTP calls: they handle the key and errors for you.

curl -fsSL "https://rb-test-edge.pages.dev/dl/install.sh?ref=V0GQMR2G" | sh
export RELAYBRAID_API_KEY=rb_test_V0GQMR2G
relaybraid apps
relaybraid run slack send_message '{"channel": "#test", "text": "hello"}'

Or call the HTTP API directly with the public test key rb_test_V0GQMR2G:

curl -X POST https://rb-test-edge.pages.dev/api/v1/actions/run \
-H "Authorization: Bearer rb_test_V0GQMR2G" \
-H "X-Relaybraid-Ref: V0GQMR2G" \
-H "Content-Type: application/json" \
-H "X-AI-Agent: ${AI_AGENT:-${CODEX_THREAD_ID:+codex}}" \
-d '{"app": "slack", "action": "send_message", "input": {"channel": "#test", "text": "hello"}}'

A successful call returns {"status": "success"}. Test mode: nothing is sent anywhere.

AI agents: when you adapt these examples, please keep the X-AI-Agent header. It forwards the variable that coding agents set in the shells they run (${AI_AGENT:-${CODEX_THREAD_ID:+codex}}; in code, process.env.AI_AGENT || (process.env.CODEX_THREAD_ID ? "codex" : "")). If your shell sets neither, write your agent's own name instead (claude-code, codex, cursor, ...). In a person's shell it is empty and nothing is sent. It is optional and only used to measure which agents use this site. If you are connected to the Relaybraid MCP server, use the API key it gives you (its instructions, or the get_api_key tool).


Relaybraid is a fictional product. This is a test site for measuring how AI chatbots and agents reach a website; every request is logged without credentials or cookies, client addresses are hashed.