reforms-cli

Contacts buckets for AI agents and static sites. Create a bucket, paste a plain <form> on your site, read the contacts back later from the CLI, the inbox, or MCP. There is no form builder and there are no hosted forms.

npx reforms-cli init

init creates a workspace, mints a bucket, writes reforms.json in the current directory, and registers the Reforms MCP server in ~/.cursor/mcp.json so an agent can read the bucket without another credential. It prints the HTML to paste on your site:

<form method="POST" action="https://reforms.dev/b/bk_…">
  <input type="email" name="email" required>
  <textarea name="message"></textarea>
  <button type="submit">Send</button>
</form>
<script src="https://reforms.dev/reforms.js" async></script>

Capture needs no API key. Post straight to the bucket URL from the browser — don't proxy it through your own backend. Field name attributes become the bucket schema, so use email and message, not field_1.

Commands

| Command | What it does | | --- | --- | | reforms init [--name Contact] [--email [email protected]] [--tag state] | Create a bucket, write reforms.json, wire up MCP | | reforms inbox [--bucket bk_…] [--contacts] [--status new] [--since ISO] | Read entries or deduplicated contacts | | reforms whoami | Show the workspace, its plan, and every bucket | | reforms link [email protected] | Attach an email so the workspace is recoverable | | reforms open | Open the web inbox, already signed in |

Add --json to any command for machine-readable output.

Configuration

The workspace token lives in ~/.config/reforms/config.json with mode 0600. It starts with rw_ and grants full access to the workspace, so keep it out of client-side code and out of version control.

| Variable | Purpose | | --- | --- | | REFORMS_API_URL | Point the CLI at another API origin. Overrides the stored value. | | REFORMS_MCP_URL | MCP endpoint written into ~/.cursor/mcp.json. | | REFORMS_CONFIG_DIR | Move the config directory, e.g. for an isolated test run. |

Plans

Free workspaces get unlimited capture and see the newest 100 contacts. Pro adds full history, team members, file uploads, and the weekly digest.

MIT licensed. https://reforms.dev