Quickstart

From nothing to your agent reading its first event, in about three minutes.

You need Node.js 22.12 or later, an email address you can read, and Claude Code or Codex (optional: any MCP client works, see Other MCP clients and REST).

1. Run init in your project folder

cd my-project
npx brynth init

init asks a few questions and then:

1. sends a sign-in link to your email and waits, up to 15 minutes, until you open it and press Confirm;
2. creates a Brynth project (the name defaults to the folder name);
3. saves the project's admin key in ~/.config/brynth/credentials.json (mode 0600; BRYNTH_CONFIG_DIR moves it, see the CLI reference);
4. connects the agents you pick, Claude Code and Codex by default, each with its own key;
5. installs the Brynth skill in this folder for each agent it connected (.claude/skills/brynth/SKILL.md for Claude Code, .agents/skills/brynth/SKILL.md for Codex), unless you pass --no-skill;
6. creates two sources: an email address (email) and a test webhook (test);
7. links Telegram for approvals, if you say yes when asked or pass --telegram;
8. prints a test request and what to ask your agent.

An account can have up to 3 projects.

2. Send the test webhook

init ends with a command like this one, with your own URL:

curl -X POST "https://hooks.brynth.ai/w/…" -H "content-type: application/json" \
  -d '{"hello":"brynth"}'

Brynth answers 200 and queues the event.

3. Ask your agent

Open Claude Code or Codex in the same folder and ask:

Check my Brynth inbox.

The agent calls session_hello, then inbox_list, and finds a webhook.received event from the test source with the payload {"hello":"brynth"}. The event is marked external_untrusted: the skill tells the agent to treat its content as data, never as instructions.

Without questions

In scripts and CI, pass everything as flags:

npx brynth init --yes --email you@example.com --client claude-code,codex

With --yes, --email is required, and no agent is connected unless you name it with --client. Add --json to get one JSON object on stdout.

Next

• Stripe webhooks in Claude Code
• Your agent asks permission on Telegram
• Send email
• Check the setup any time with npx brynth status, and read the ledger with npx brynth logs.