WordVibe — Quick docs

The minimum to wire the WordPress plugin into WordVibe and start chatting with an AI that calls WordPress tools for you.

1 · Install

  1. Download the plugin ZIP (link in your account dashboard).
  2. WordPress admin → Plugins → Add New → Upload Plugin → drop the ZIP → Activate.
  3. Sign up at /app. You get a license key on signup.
  4. WordPress admin → WordVibe menu → paste your license key → save.
  5. Open the chat panel and say hi. The first reply confirms the connection.

2 · How the architecture works

The plugin is open-source (GPL) and holds your local capability policy — which files the AI can read/write, which DB tables it can touch, etc. The server is closed and holds the orchestrator, system prompts, and LLM credentials. Every tool the agent calls runs on your WordPress host; every reasoning step runs on our server.

Two transports

Relay mode (default): the plugin POSTs the goal to WordVibe, then polls. Works everywhere; the long connection is held by the WordPress host's PHP-FPM.

Browser-direct mode (cap-immune): the chat opens an EventSource straight to WordVibe's servers. The WordPress host is removed from the long-lived connection entirely, so a 120s LiteSpeed/Hostinger proxy cap can no longer kill a long agentic run. Toggle in WordVibe → Browser-direct streaming.

3 · Model routing

Your subscription tier caps which models the router can pick:

You can request a specific model in the chat composer; the server downgrades to your tier ceiling if it's outside your plan.

4 · API surface (if you want to script against it)

// health
GET  /v1/health

// start an async agentic run (browser-direct mode)
POST /v1/runs/start
     { goal, context, options, tools_manifest, browser_tools:true }
     → { run_id, session_id }

// live SSE event stream for that run
GET  /v1/runs/:id/stream

// deliver a tool result back (browser-direct mode)
POST /v1/runs/:id/tool_result
     { call_id, ok, result, error }

// sync run (non-browser callers; bounded by host timeout)
POST /v1/runs
     { goal, context, options, tools_manifest, callback_url, callback_secret }

5 · Plans

Tier comparison + checkout — coming soon. While we finalise pricing, sign up free and bring your own API key.

6 · Support

Open the chat in WP admin and ask. The AI knows about itself. For human help: hello@wordvibe.io.