Able

Able is an open-source, agent-first ERP for service businesses. It is designed as a set of deep business modules that agents can operate through small, task-shaped interfaces without collapsing the business into generic CRUD.

Able Desk is the first application. It combines a support desk, customer directory, CRM, communications inbox, durable operations, and controlled improvement records on Cloudflare Workers. MCP is the normal operator interface; customers use an accessible support portal and approved channels; /ops is a small Cloudflare Access-protected recovery surface.

Project status: early V1. The architecture and core Desk flows are implemented and tested, but Able does not yet claim production readiness. A deployed Worker is not, by itself, an operational support desk.

Project site · V1 contract · Roadmap · Architecture overview · Architecture reference

Why agent-first

The normal Desk loop is intentionally small:

1. able_case_next returns a complete decision workspace.
2. able_case_reply commits a reply against its exact opaque revision.

The module—not the agent or transport adapter—owns lifecycle policy, authorization, audit evidence, idempotency, delivery intent, and concurrency checks. MCP, the portal, email, WhatsApp, and /ops authenticate, translate, and render.

What Desk V1 includes

• Case queues, search, assignment, priority, lifecycle, public replies, and private notes
• Public knowledge, request intake, private case links, attachments, and bounded attachment evidence
• Browser text help, optional voice input, and optional read-only Shopify order lookup
• Channel-neutral conversations with explicit routing to support, sales, both, or no work
• Signed WhatsApp text ingress and conversation-owned replies
• Canonical parties, CRM relationships, sourced activities, and scheduled follow-ups
• Durable operations, immutable receipts, outcome observations, and inactive evaluation-gated improvements
• Cloudflare Access identity for MCP and /ops, plus a public portal protected by capabilities and Turnstile
• D1, private R2 objects, Workers AI, Cloudflare Email Service, and a durable outbox

The exact scope and exclusions are binding in docs/product-v1.md.

Repository structure

able/
├── apps/
│   └── desk/          # Buildable Desk Worker, migrations, tests, assets, and configs
├── packages/          # Future reusable modules, extracted only behind proven interfaces
├── docs/              # Product contract, architecture visuals, ADRs, deployment, and roadmap
├── scripts/           # Repository-wide publication and history gates
└── .github/           # CI, security scanning, and contributor templates

Desk remains one honest buildable workspace for the first public release. Modules will move to packages/ only when each has an independent interface and test boundary; see packages/README.md.

Develop

Requirements: Node.js 22 or 24+, npm, and a Cloudflare account for remote deployment.

npm install
npm run dev:parity

dev:parity migrates and seeds a persistent local-only workspace, then runs the same Worker entry point and browser assistant used by a deployment. It uses remote Workers AI, so authenticate once with npx wrangler login. D1, R2, queues, Durable Objects, email, and all fixture data remain local. See the development workflow for parity limits and optional development-store configuration.

Copy apps/desk/.dev.vars.parity.example to apps/desk/.dev.vars only when local integrations need private values. Never commit the resulting file. The separate .dev.vars.example documents deployment setup and contains deliberate placeholders that must not be used by the parity server.

Run the complete local gate before opening a pull request:

npm run check

Changes to voice prompts or tool descriptions also require:

npm run eval:voice

Upstream and proving deployments

This repository is the canonical development source. Hosted proving grounds deploy exact commits through protected environments; they are not private product forks. Tenant secrets, resource coordinates, content, customer data, and operational runbooks remain outside source control. A lesson found in a proving deployment becomes a generic issue, neutral test, and upstream change here.

See docs/development.md for the full workflow and docs/deployment.md for the deployment boundary.

Community

Questions belong in Discussions; bugs and proposals belong in issues. See CONTRIBUTING.md, GOVERNANCE.md, SECURITY.md, and CODE_OF_CONDUCT.md.

Able is licensed under Apache-2.0.