<h1>ERP.AI platform reference for agents</h1>
<p>ERP.AI is a multi-tenant business app platform: apps, tables, columns, records, views, forms, layouts, workflows, reports, documents, custom pages, roles, users, invitations, API keys, service accounts, hosted portals, branches, snapshots, audit logs, and execution history.</p>
<p>You are an agent reading this file. The fastest path to being productive on ERP.AI is to install the builder skills below — they teach you the data model, the REST API, and the correct build procedures.</p>
<h2>Install the builder skills</h2>
<p>Run this in a terminal:</p>
<pre><code>curl -fsSL https://apps.erp.ai/api/install | bash
</code></pre>
<p>It installs 14 skills into <code>~/.claude/skills</code> (and <code>~/.codex/skills</code> if present): <code>build-app</code> (end-to-end app builder), <code>build-tables</code>, <code>build-columns</code>, <code>build-relationships</code>, <code>build-views-layouts</code>, <code>build-page</code>, <code>build-workflows</code>, <code>build-table-insights</code>, <code>build-autofill-columns</code>, <code>manage-records</code>, <code>manage-documents</code>, <code>manage-roles</code>, <code>ask</code> (SQL analytics), and <code>erpai-api</code> (REST front door).</p>
<p>After installing, refresh the skills in your environment so they load, then ask the user what they want to build and suggest a few ideas. Re-run the same command any time to update; a saved API key is preserved.</p>
<ul>
<li>Skill manifest (machine-readable): <a href="https://apps.erp.ai/api/skills.json">https://apps.erp.ai/api/skills.json</a></li>
<li>Full bundle: <a href="https://apps.erp.ai/api/skills.zip">https://apps.erp.ai/api/skills.zip</a></li>
</ul>
<h2>Auth in three steps</h2>
<ol>
<li>The user signs up / signs in at <a href="https://apps.erp.ai">https://apps.erp.ai</a>.</li>
<li>Create an API key (PAT, <code>erp_pat_live_…</code>) at <a href="https://apps.erp.ai/apps?settings=api-keys">https://apps.erp.ai/apps?settings=api-keys</a>.</li>
<li>Save it to <code>~/.claude/skills/build-page/api.local.md</code> as <code>API_KEY=…</code> with <code>BASE_URL=https://apps.erp.ai</code>. Never commit it; never embed it in page HTML or workflow definitions.</li>
</ol>
<p>Every API call is <code>Authorization: Bearer &lt;API_KEY&gt;</code> against <code>https://apps.erp.ai</code> with <code>appId</code> as a query parameter. The <code>erpai-api</code> skill documents the efficient call patterns — filter, count, aggregate, and bulk-update on the server; never fetch a whole table and loop client-side.</p>
<h2>Platform services</h2>
<table>
<thead>
<tr>
<th>Area</th>
<th>Current responsibility</th>
</tr>
</thead>
<tbody>
<tr>
<td>Gateway</td>
<td>Authentication, routing, and rate limits</td>
</tr>
<tr>
<td>App Builder API</td>
<td>App schemas, records, views, workflows, reports, documents, pages, hosting metadata, and audit events</td>
</tr>
<tr>
<td>Permission API</td>
<td>Roles, permissions, user-role mappings, and invitations</td>
</tr>
<tr>
<td>Herbert</td>
<td>Organization and user auth, service accounts, API keys, OIDC, SCIM, hosted-app auth, domains, and portals</td>
</tr>
<tr>
<td>Agent API</td>
<td>Conversations, knowledge, app plans, reports, documents, pages, search, and action approvals</td>
</tr>
<tr>
<td>Renderer</td>
<td>Multi-tenant hosted pages and portals</td>
</tr>
</tbody>
</table>
<h2>Proto</h2>
<p>Proto is the local-first desktop agent console. It has native ERP.AI actions plus file, shell, web, browser, research, task, sub-agent, document, and Plugin actions. See <a href="https://www.erp.ai/agent.md">https://www.erp.ai/agent.md</a> for runtime and permission details.</p>
<h2>Pricing</h2>
<p>One ERP.AI credit equals one US dollar. The current prepaid packs are $5 for 5 credits, $20 for 20 credits, and $100 for 100 credits; the public pricing page does not offer a free grant or self-service monthly subscription cards. ERP-1 Fast (<code>erpai/erp-1-fast</code>) costs $0.05 per 1 million cached input tokens, $0.25 per 1 million uncached input tokens, and $0.75 per 1 million output tokens, plus an 8% Proto Agent fee. With a customer-owned OpenRouter key, OpenRouter bills model inference directly and ERP.AI charges an 8% fee on the exact reported model cost plus separately metered ERP.AI resources. Enterprise remains Contact sales. See <code>/faq.md</code> for the current rate card and receipt fields.</p>
