Title: Chagency
Author: Jordy Meow
Published: <strong>5 Bealtaine, 2026</strong>
Last modified: 15 Bealtaine, 2026

---

Search plugins

![](https://ps.w.org/chagency/assets/banner-772x250.png?rev=3532754)

![](https://ps.w.org/chagency/assets/icon-256x256.png?rev=3532754)

# Chagency

 By [Jordy Meow](https://profiles.wordpress.org/tigroumeow/)

[Download](https://downloads.wordpress.org/plugin/chagency.0.0.2.zip)

 * [Details](https://ga.wordpress.org/plugins/chagency/#description)
 * [Reviews](https://ga.wordpress.org/plugins/chagency/#reviews)
 * [Development](https://ga.wordpress.org/plugins/chagency/#developers)

 [Support](https://wordpress.org/support/plugin/chagency/)

## Description

**Chagency** is the first chatbot to ship on top of the new AI infrastructure introduced
in WordPress 7. A small, native plugin that lets you talk to your site through whichever
AI provider you have configured. It runs in the WordPress admin and, when you turn
it on, on every page of your public site.

The name (chat + ai + ency) is meant as a small bridge between the new AI primitives
shipped with WordPress and the broader world of chat and agents. It starts as a 
chatbot today and grows alongside the Abilities API into an agent that can take 
real actions tomorrow.

### 🪨 Built on WordPress, period

Chagency relies entirely on what WordPress 7 ships in core:

 * `wp_ai_client_prompt()`, the AI Client API.
 * `wp_get_connectors()`, the Connectors API.
 * `wp_register_ability()` / `wp_get_ability()`, the Abilities API.
 * `@wordpress/components`, `@wordpress/element`, `@wordpress/boot`, the Gutenberg
   toolkit.

That is the entire dependency surface. **No bundled AI vendor SDKs, no third-party
JavaScript libraries beyond the Gutenberg stack, no telemetry, no phone-home.** 
The plugin stays small on purpose: fewer moving parts means less friction, fewer
security holes, less to break when WordPress, browsers, or providers change.

You will need at least one AI provider plugin (e.g. _AI Provider for Anthropic_,
_AI Provider for Google_, _AI Provider for OpenAI_) to talk to a model. That is 
WordPress 7’s architecture: providers are separate plugins that register a Connector.
They are not a Chagency dependency.

💡 **Tip:** For the smoothest setup, install [AI Engine](https://wordpress.org/plugins/ai-engine/).
It registers every AI provider it manages as a Connector, so a single configuration
covers all your WordPress 7 AI plugins (including Chagency). Every request then 
flows through one clean, unified system.

### 🪄 What you get

 * A floating chat panel pinned to the bottom-right of every page (admin and / or
   public site, controlled by two independent toggles).
 * A single settings page under **Settings  Chagency**, with the bare minimum: where
   to show the chatbot, the chat title, the greeting, the system instruction, and
   the model preference.
 * Live updates: flipping a toggle in Settings shows or hides the launcher immediately
   on the same page, no reload needed.
 * Per-provider **Test** buttons that fire a canary prompt and report round-trip
   time.
 * Conversation persistence in your browser’s localStorage, scoped per user.
 * Placeholder expansion (`{user_name}`, `{site_name}`, `{current_page}`, `{current_url}`,`{
   user_role}`, `{site_url}`) so the assistant always knows who and where it is.
 * Exposed as an Ability (`chagency/send-message`) so other plugins, MCP clients,
   and AI agents can invoke Chagency directly.

### 🚀 Getting started

 1. Install and activate **Chagency**.
 2. Install and configure at least one AI provider plugin under **Settings  Connectors**(
    we recommend [AI Engine](https://wordpress.org/plugins/ai-engine/), which exposes
    all its providers as Connectors at once).
 3. Click the chat launcher in the bottom-right of any admin page and start talking.
 4. Want it on the public site too? Open **Settings  Chagency** and flip the second
    toggle.

### 🙋 Frequently Asked Questions

#### Why “Chagency”?

It’s a portmanteau of _chat_, _AI_, and a bit of _agent_. Not “agency” in the sense
of a marketing shop. The plugin starts as a minimal chatbot for the new WordPress
7 AI framework and grows alongside the Abilities API into a true agent.

#### Does it need WordPress 7?

Yes. It uses `wp_ai_client_prompt()`, `wp_get_connectors()`, and the Abilities API,
all added in WordPress 7.0. On older versions it refuses to boot and tells you why.

#### Which AI providers are supported?

Whatever you configure under **Settings  Connectors**. Chagency is provider-agnostic.
Anthropic, Google, OpenAI, or any third-party Connector are treated equally.

#### Can visitors on the front end use it?

Yes. Open **Settings  Chagency** and turn on _Show on the public site_. The chat
then appears for every visitor, signed in or not.

#### Does it store my conversations?

No. Conversations live only in your own browser (localStorage, per user). Hit _Reset_
in the panel to clear them. Nothing is stored server-side.

#### Can I use it as a building block in my own plugin?

Yes. The `chagency/send-message` Ability is registered on `wp_abilities_api_init`
and can be called with `wp_get_ability( 'chagency/send-message' )->execute( array('
message' => '...' ) )`.

### Source code

The unminified React / JavaScript source is shipped inside the plugin folder under`
src/`, alongside the compiled output in `build/`. Public source repository: https://
github.com/jordymeow/chagency

To rebuild from source:

    ```
    pnpm install && pnpm run build
    ```

The build is `@wordpress/scripts` (webpack) with no custom plugins or transforms.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Chagency” is open source software. The following people have contributed to this
plugin.

Contributors

 *   [ Jordy Meow ](https://profiles.wordpress.org/tigroumeow/)

[Translate “Chagency” into your language.](https://translate.wordpress.org/projects/wp-plugins/chagency)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/chagency/), check out
the [SVN repository](https://plugins.svn.wordpress.org/chagency/), or subscribe 
to the [development log](https://plugins.trac.wordpress.org/log/chagency/) by [RSS](https://plugins.trac.wordpress.org/log/chagency/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 0.0.2 (2026/05/15)

 * Add: option to show the chat widget on the public site for all visitors
 * Add: configurable chat title in the Settings page
 * Add: chat panel stays open when navigating between admin pages
 * Update: launcher, chat panel, and Settings page styled to match the WP 7 AI plugin
 * 🌴 Keep us motivated with [a little review here](https://wordpress.org/support/plugin/chagency/reviews/).
   Thank you!

#### 0.0.1

 * Initial release.

## Meta

 *  Version **0.0.2**
 *  Last updated **2 lá ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 7.0 or higher **
 *  Tested up to **7.0**
 *  PHP version ** 7.4 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/chagency/)
 * Tags
 * [abilities](https://ga.wordpress.org/plugins/tags/abilities/)[agent](https://ga.wordpress.org/plugins/tags/agent/)
   [AI](https://ga.wordpress.org/plugins/tags/ai/)[assistant](https://ga.wordpress.org/plugins/tags/assistant/)
   [chatbot](https://ga.wordpress.org/plugins/tags/chatbot/)
 *  [Advanced View](https://ga.wordpress.org/plugins/chagency/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/chagency/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/chagency/reviews/)

## Contributors

 *   [ Jordy Meow ](https://profiles.wordpress.org/tigroumeow/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/chagency/)