1. Choose your website and agent.

Copy the instruction for your coding agent to use in your existing website, or download a runnable starter. Each starter includes an inactive installation, a shared layout and its own run instructions. It runs locally without an account or a secret.

Your agent can choose the official npm installer for Next.js, React and HTML, or the Python installer on PyPI for Django, Flask and shared HTML templates. The Python CLI needs Python 3.10 or newer and runs without Node.js. Follow the machine-readable installation manifest for the pinned versions and next actions.

Choose one agent for this installation. Support and Sales have separate settings and allowed origins. You can install the other agent separately after reviewing the first integration.

Give your coding agent one instruction

Open your website repository and paste this instruction into your coding agent. It prepares the local integration before asking for your setup key.

You can also select and copy the text above.
Install from the terminal

Run in your website repository. Omit --write to preview the plan.

npm exec --yes --package=kawlnow@0.1.3 -- kawlnow init --channel support --write --json

Finish the shared layout or template and project checks, then check the local installation with your verified production origin before supplying a key:

npm exec --yes --package=kawlnow@0.1.3 -- kawlnow doctor --channel support --site-origin https://YOUR_PRODUCTION_DOMAIN --json

View the official npm package. Read the installation manifest.

Start with a runnable example

The Next.js starter has an inactive support installation. Its README explains how to run it locally, connect the selected agent and check the result.

Download Next.js support starter

These existing starters pin npm 0.1.2. Resume each starter with its own installed CLI and README; keep the installer version that created its plan.

When the site is ready, start free or sign in to create a setup key.

2. Connect your account after the website is ready.

Start free or sign in, select the intended brand and agent in Installation, then create a setup key. It expires after 24 hours. Give it directly to the hidden terminal prompt or your agent’s trusted secret input. Keep it out of chat prompts, command arguments, source files and browser code.

Your coding agent completes the dependencies and shared layout or template, runs the project checks, and follows the installer’s read-only doctor before requesting the key. The doctor checks local preparation and the verified production HTTPS origin; account connection, browser inspection and published-page verification are separate steps.

Use the connect command in your starter README or the same installer version that prepared your site. The installer discovers the public brand ID and connects the prepared files. Add only the verified production HTTPS origin and preserve existing allowed origins. For localhost testing, follow the local guide linked below.

A setup key can read installation status, merge verified origins and check the published page. Knowledge approval, billing, private testing and customer-call enablement remain with you. Optional browser OAuth connects an MCP client for broader scoped setup and knowledge drafts.

3. Check the page, then test your agent.

Use the local checker for HTTPS, exact origins, Content Security Policy and microphone delegation. Paste the headers from your own page’s Network panel. The checker runs in your browser and does not fetch your website.

Publish when authorised, inspect the widget after hydration and navigation, then run the Installation panel’s published-page verifier. Static checks cannot establish microphone audio, answer quality or human handover. Approve your sources and complete a successful private dashboard test before enabling customer calls.

Your first 50 conversations are free across your account, shared by all brands, support, sales and setup tests. The allowance is one-time and does not renew monthly. After the free allowance, calls lasting at least 15 seconds cost £2.50 GBP each, plus applicable tax. Shorter calls are free, with no per-minute or overage charges.

Common questions

Do I need an account before downloading a starter?

No. Download and run the inactive starter first. An account and a temporary setup key are needed when you connect it to your selected brand and Support or Sales agent.

Does installing the widget start a call?

No. The starters are inactive until connected. Installation does not approve knowledge, enable customer calls or start a conversation. You control those steps in the dashboard.