Teddy

Teddy#

Modular, provider-agnostic AI assistant for WordPress 8+ built on the native WordPress AI Client and Abilities API.

Features#

User-facing catalog: docs/06-features.md · Quick how-to: docs/07-user-guide.md

On by default: Teddy Copilot, visitor chat (widget / shortcode / block), SEO assistant, Teddy Writer, WooCommerce tools, streaming, English + Vietnamese.

Shipped, off by default: Knowledge / RAG, Agent Pipeline (Observability + Security UI), Workflows, Extension SDK, Facebook Messenger (Channels).

OpenClaw: MCP bridge in mcp-server/ + buyer wizard in openclaw/ (teddy-openclaw setup). Docs: docs/modules/mcp-bridge/openclaw-onboarding.md.

Not in GA: Enterprise items (multisite fleet, external vector DB, SSO/SIEM) — see features doc §8. Instagram / Zalo / Page publish — see docs/modules/channels/PHASE-2.md.

Requirements#

• WordPress 6.9+ with AI Client package
• PHP 8.2+
• MySQL/MariaDB
• Node.js 18+ (build only)
• Composer (PHP dependencies)

Development#

cd wp-content/plugins/teddy
composer install
npm install
npm run build          # webpack + CSS + i18n
composer test:unit
composer test:integration
composer phpstan
composer test:coverage # Domain coverage gate (pcov optional)

E2E (requires Laragon/site PHP with mysqli, PHP 8.2+)#

C:\Users\vinhnx\laragon\bin\php\php-8.5.7-Win32-vs17-x64\php.exe tests/e2e-all.php

Playwright admin smoke (needs password):

set TEDDY_E2E_USER=vinhnx
set TEDDY_E2E_PASS=your-password
npm run test:e2e:playwright

Release#

One command (build JS/CSS/i18n + production Composer + ZIP):

npm run release:full   # → release/teddy.zip

Manual steps (same result):

npm run build
composer install --no-dev --optimize-autoloader
npm run release

Documentation#

License#

GPL-2.0-or-later