Skip to main content

Building with AI Agents

Vibe is designed so AI agents can develop and ship a complete app end-to-end — scaffold the project, write the code, build it, create the app, deploy it, and iterate — with exactly one human action in the entire workflow: clicking Approve in the browser during facilio login.

That's it. From a fresh machine to a live URL, the agent handles everything else: installing Node, installing the CLI, scaffolding the framework, wiring the SDK, building, creating the app, deploying, and iterating on subsequent changes.

The agent autonomy contract#

StepWho does it
Install Node.js / npmAgent (via nvm, no sudo)
Install @facilio/cli and @facilio/vibe-sdkAgent
Scaffold the project (any framework)Agent
facilio login — one-time OAuth approvalUser clicks "Approve" in browser once
facilio vibe app create (prompts for a name)Agent
Write the source code (HTML/JS/React/Vue/…)Agent
Discover connectionSlug / actionSlug / payload shapes via facilio connections search / schemasAgent
npm run build && facilio vibe deployAgent
Iterate ("change the button color", "add a section")Agent — no further login / app create needed

After facilio login, the agent reports the live URL to the user and is ready to take further requests.

The llms.txt reference#

Hand this URL to any AI agent and it has the complete build-and-deploy guide for Vibe:

https://facilio.com/developers/docs/vibe/llms.txt

It covers:

  • The four-step workflow (login → app create → build → deploy)
  • Hard constraints (index.html in the build output root, static-only, browser-cookie auth, executeAction is the only data path)
  • Node bootstrap via nvm with no sudo
  • CLI install with fallback to npx when global install fails
  • SDK setup for both bundlers and plain HTML
  • The getCurrentUser() → vibe.login() gating pattern
  • The executeAction(connectionSlug, actionSlug, payload) data path and the facilio connections CLI as the discovery + verification tool
  • End-to-end React + Vite example
  • Minimal vanilla-HTML example
  • Pre-deploy checklist

Open llms.txt — the full document.

One-prompt recipes#

Claude (Claude Code, Claude.ai, Claude API)#

Read https://facilio.com/developers/docs/vibe/llms.txt
Build me a Facilio Vibe dashboard that lists my assets grouped by site.Use React + Vite. Wire SDK auth (getCurrentUser → login fallback),call vibe.executeAction('facilio-cmms', 'list-assets'), and group theresult by siteId. When done, run `npm run build && facilio vibe deploy` andprint the live URL.
I'll click "Approve" in the browser when facilio login opens it — that'sthe only thing I'll do.

For ongoing work, create a Claude Project and add https://facilio.com/developers/docs/vibe/llms.txt as a knowledge source. Every conversation in that project has Vibe context built in.

ChatGPT (web, GPT-4 / GPT-5, Custom GPTs)#

Read https://facilio.com/developers/docs/vibe/llms.txt
Build a Facilio Vibe app: a vendor portal showing open workorders forthe signed-in user. Use plain HTML + the SDK from CDN — no bundler.
Ship it: write index.html and app.js into a dist/ folder, writevibe.json, run `facilio login`, then `facilio vibe app create` (enter "Vendor Portal"when prompted for the name), then `facilio vibe deploy`. Print the live URL when done.

You can also create a Custom GPT with the URL added to its configuration so every conversation has SDK context.

Cursor / VS Code#

@url https://facilio.com/developers/docs/vibe/llms.txt
Add a new Vibe app to my workspace: a one-page tool that lets atechnician check in/out of a workorder. Discover the right actionslugs and payload shapes with `facilio connections search` and`facilio connections schemas <slug> --with-output`. Scaffold withVite + React, wire the SDK, build, and deploy.

Or drop llms.txt into your project root — Cursor automatically includes it as context.

Lovable#

Read https://facilio.com/developers/docs/vibe/llms.txt
Build a Facilio Vibe dashboard widget showing a bar chart ofwork orders grouped by status. Use Vue 3 + Vite. Follow the SDKpatterns from the documentation — the app runs at its ownsubdomain and uses browser-cookie auth.

Discovering Facilio actions via the CLI#

Agents shouldn't invent connectionSlug / actionSlug strings. Use the facilio connections CLI — it runs on the same facilio login session, so discovery, schema lookup, and a live dry-run all happen in one place:

facilio connections search "list assets"                              # find the actionfacilio connections schemas facilio-cmms.list-assets --with-output    # input + response schemasfacilio connections execute facilio-cmms.list-assets --params '{}' --dry-run   # validate the payloadfacilio connections execute facilio-cmms.list-assets --params '{}'    # real call — same code path the SDK takes

This gives the agent:

  • Every available connection (e.g. facilio-cmms)
  • Every action under each connection (e.g. list-assets, create-workorder)
  • The input schema for the action's payload
  • The response schema so the agent knows how to parse the result
  • A working live example call that proves the slug + payload combination is correct before it's wired into app code

Agent workflow:

  1. User asks for "a dashboard showing my assets."
  2. Agent runs facilio connections search "list assets", finds facilio-cmms.list-assets.
  3. Agent runs facilio connections schemas facilio-cmms.list-assets --with-output to read input/output schemas.
  4. Agent runs facilio connections execute … --dry-run (and optionally a real execute) to validate.
  5. Agent writes vibe.executeAction('facilio-cmms', 'list-assets', {...}) with the verified payload.

This is why Vibe works for agents: there's a deterministic, executable source of truth for both what's available and how to call it, right there in the terminal.

Tips for better results#

  1. Always include the llms.txt URL — https://facilio.com/developers/docs/vibe/llms.txt.
  2. Name the framework you want — "React + Vite", "plain HTML", "Vue 3", etc. The bundler / build output is the most error-prone step.
  3. Be specific about the data — "list assets grouped by site" beats "show me data". The agent can then resolve the right action via facilio connections search.
  4. Let the agent run facilio login itself, and warn the user once: "A browser tab will open — click Approve to finish signing in. That's the only thing I need from you."
  5. For iteration prompts, agents only need to re-run npm run build && facilio vibe deploy. No more login or app create.

Reference#

On This Topic