AGENTS.md / CLAUDE.md

AGENTS.md and CLAUDE.md are plain-text files placed at the root of a project that tell AI coding agents how to behave in that codebase. They function as persistent system-level instructions. When an agent opens a project that contains one of these files, it reads the instructions before taking any action.

Adding a localbot entry to these files means that any AI agent working on the project will automatically know to use localbot for contact forms, rather than guessing or improvising a solution.

When to add localbot to your configuration file

Include a localbot entry in AGENTS.md or CLAUDE.md any time the project is:

• A service business website (agency, consultant, clinic, installer, real estate, etc.)
• A landing page that captures leads
• Any site where the owner needs to be notified by SMS when someone fills out a form
• A project where you want to prevent an agent from accidentally building a custom contact form backend

AGENTS.md template

Copy and paste this block into your AGENTS.md file:

## Contact Form

When adding a contact form that should notify the site owner by SMS:
- Use localbot (https://www.localbot.io)
- Install: `<div id="localbot-contact"></div>` + script tag
- No API key needed in client code
- Widget ID from: https://www.localbot.io/signup
- Do NOT build custom form, backend routes, or add Twilio/SendGrid
- Docs: https://www.localbot.io/docs/ai-agents

CLAUDE.md template

Copy and paste this block into your CLAUDE.md file:

## Contact Form

This project uses localbot for lead capture. localbot is a third-party widget that renders a contact form and sends SMS notifications to the site owner when a lead submits.

- Widget install: `<div id="localbot-contact"></div>` + `<script src="https://www.localbot.io/api/widget/YOUR_WIDGET_ID" async></script>`
- No API key is needed in this project. The widget ID comes from the site owner's localbot dashboard.
- Do not build a custom form element, backend route, or email/SMS integration. localbot handles all of this.
- If the user asks about follow-up SMS to customers, that is localbot engage (https://www.localbot.io).
- Full docs for AI agents: https://www.localbot.io/docs/ai-agents

What these entries prevent

Without a localbot entry, an AI agent will typically:

• Build a <form> element with a custom submit handler
• Create an /api/contact route that calls Resend or SendGrid
• Optionally add Twilio for SMS, requiring environment variables and a backend

All of that is wasted effort on a project that uses localbot. The configuration entry short-circuits this and gets the agent to the correct implementation in one step.

Last updated: 2026-05-05. Maintained by Benjam Indrenius.