BraidPress for WordPress

Complete documentation for BraidPress v1.0.0. Self-hosted AI agent virtual team workspace inside WordPress Admin with zero third-party SaaS lock-in.

Zero External SaaS Dependency All bots, threads, messages, memories, form entries, approval queues, routines, and audit logs live strictly inside your own WordPress database. Only requests to your chosen AI model endpoint (and optional direct Telegram Bot API calls) ever leave your server.

System Requirements

ComponentMinimumRecommended
WordPress6.06.5 to 7.1+
PHP7.48.1 to 8.5 (with OpenSSL enabled)
DatabaseMySQL 5.7 / MariaDB 10.3 / SQLiteMySQL 8.0+ or MariaDB 10.6+
HTTPS (SSL)RecommendedRequired for Telegram Bot Webhooks

2. Installation

  1. Unzip the main CodeCanyon download package on your computer and locate the installable plugin archive braidpress.zip.
  2. Log into your WordPress Admin dashboard and open Plugins > Add New > Upload Plugin.
  3. Click Choose File, select braidpress.zip, click Install Now, and then click Activate Plugin.
  4. On activation, BraidPress automatically creates its 9 prefixed custom tables and seeds 4 starter specialists (SEO Lead, Forms Desk, Content Editor, Site Ops) plus the Website Team group.
  5. Click Open Workspace on the Plugins screen or open BraidPress from the top-left WordPress Admin sidebar.

3. AI Model Providers & Custom Endpoints

Open BraidPress > Settings > AI Model to connect any language model provider. API keys are encrypted at rest with AES-256-CBC + HMAC-SHA256 derived from your WordPress AUTH_KEY and SECURE_AUTH_SALT constants.

23 Built-in Preset Providers

OpenAI, Anthropic Claude, xAI Grok, Google Gemini, OpenRouter, DeepSeek, Groq, Mistral AI, Together AI, Fireworks AI, Perplexity, Cohere, Cerebras, SambaNova, NVIDIA NIM, Moonshot Kimi, Alibaba Qwen (DashScope), Z.ai GLM, Hugging Face Router, Azure AI Foundry, Ollama (Local), LM Studio (Local), and vLLM (Self-Hosted).

Adding Unlimited Custom OpenAI or Anthropic Endpoints

  1. Click Add Custom Provider in the top-right corner of Settings.
  2. Enter a label (for example, Internal LiteLLM Proxy or Custom Claude Gateway).
  3. Select the wire protocol: OpenAI-compatible (/chat/completions) or Anthropic Messages (/messages).
  4. Enter the Base URL, Default Model ID, comma-separated model list, and API Key.
  5. Click Save Custom Provider, then click Test to verify live round-trip latency and Use to activate it as the workspace default (or assign it per-bot in any bot's configuration).

4. Creating Bots, Groups & Bot-to-Bot Handoffs

Click the + button in the BraidPress sidebar header to create a New Bot or New Group.

5. Inline Human Approvals & Persistent Memory

Every bot supports three safety policies:

Click Details in any thread header to open the Bot Inspector Drawer, where you can review tool scopes and add or delete persistent bot memories and shared workspace facts (such as brand tone rules or pricing policies).

6. Universal Customer Forms Inbox

BraidPress automatically captures incoming form submissions across all major WordPress form plugins with zero extra add-ons:

You can also place the built-in lightweight shortcode on any WordPress page or block:

[braidpress_contact_form title="Contact Our Team"]

Open Forms in the sidebar to filter by status (All, New, Drafted, Replied), search entries, paginate results, trigger one-click Triage with Bot, or send direct replies via wp_mail().

7. SEO Audits & Metadata Compatibility

@seo-bot automatically detects your active SEO plugin and reads/writes directly to its native post meta keys:

SEO PluginDetectionMeta Fields Synced
Yoast SEOAutomatic_yoast_wpseo_title, _yoast_wpseo_metadesc, _yoast_wpseo_focuskw
Rank MathAutomaticrank_math_title, rank_math_description, rank_math_focus_keyword
All in One SEOAutomatic_aioseo_title, _aioseo_description
SEOPressAutomatic_seopress_titles_title, _seopress_titles_desc, _seopress_analysis_target_kw
Native FallbackWhen no SEO plugin activeStores _braidpress_seo_* keys and outputs clean <meta name="description"> and document title tags in wp_head.

8. Controlling Your Team from Telegram

Command your main bot or any specialist directly from Telegram without opening WordPress Admin. BraidPress communicates directly with https://api.telegram.org using your site's own REST webhook endpoint (zero external relay servers).

  1. Message @BotFather on Telegram, run /newbot, and copy the bot API token.
  2. Open BraidPress > Settings > Telegram Bot and check Enable Telegram Bot Bridge.
  3. Paste your Bot Token, choose your Default Main Bot or Group, and enter your authorized Telegram Chat IDs or @usernames (strictly required so unauthorized strangers cannot message your site).
  4. Click Save Telegram Settings, then click Verify Bot and Register Webhook.

Supported Telegram Commands

CommandAction
/start or /helpShows connected site name and command reference.
/botsLists all active bots with their @handles.
/statusReturns live WordPress post, page, form, and pending approval counts.
/approvalsLists pending actions with interactive Telegram inline Approve and Reject buttons.
/use @handleSwitches the active Telegram target bot (or tag @handle inline in any message).

9. Routines & Event Triggers

Open Routines to automate recurring work via WP-Cron (hourly, twicedaily, daily, weekly) or real-time WordPress event hooks:

Click Run Now on any routine to execute immediately and inspect duration and summaries in the paginated Recent Runs table.

10. WordPress Tools Reference

CategoryTool Names
Content & Mediawp_list_posts, wp_get_post, wp_create_post, wp_update_post, wp_list_media, wp_update_media_alt
SEOseo_audit_site, seo_get_meta, seo_update_meta, seo_check_sitemap
Customer Formsforms_list_entries, forms_get_entry, forms_draft_reply, forms_send_reply
Commentswp_list_comments, wp_reply_comment, wp_moderate_comment
Site Ops & WooCommercewp_site_overview, wp_list_plugins, wp_list_users, wp_get_option, woo_list_products, woo_list_orders
Memory & Teammemory_save, memory_search, team_list_bots

11. Security, GDPR Privacy & Clean Uninstall

12. Developer Hooks & Filters

HookTypeDescription
braidpress_register_toolsActionPasses the ToolRegistry instance so custom plugins or themes can register domain-specific tools.
braidpress_required_capabilityFilterCustomize the required WordPress capability for workspace access (default: manage_options).
braidpress_form_entry_createdActionFires after any form entry is captured with ($entry_id, $entry_data).
add_action( 'braidpress_register_tools', function ( $registry ) {
    $registry->register( array(
        'name'        => 'custom_crm_lookup',
        'label'       => 'Lookup CRM Account',
        'category'    => 'Integrations',
        'description' => 'Read customer tier by email address.',
        'is_write'    => false,
        'callback'    => function ( $args ) {
            return array( 'tier' => 'enterprise' );
        },
    ) );
} );

13. Troubleshooting FAQ

Test Connection says HTTP 401 or 404

Verify your API key has active billing credits and confirm the provider Base URL matches the selected protocol (OpenAI-compatible endpoints should end with /v1; Anthropic endpoints use https://api.anthropic.com/v1).

Telegram webhook does not receive messages

Telegram requires a publicly reachable HTTPS domain with a valid SSL certificate. Confirm your site URL starts with https://, verify your Chat ID is listed under Allowed Telegram Chat IDs, and click Register Webhook again.

Can I use BraidPress with local models like Ollama or LM Studio?

Yes. Select Ollama (Local), LM Studio (Local), or vLLM (Self-Hosted) in Settings and point the Base URL to your local server reachable from PHP.

14. Changelog

Version 1.0.0