Title: Chagency
Author: Jordy Meow
Published: <strong>2026 ལོའི་ཟླ 5 ཚེས 5 ཉིན།</strong>
Last modified: 2026 ལོའི་ཟླ 6 ཚེས 3 ཉིན།

---

མཐུད་སྣེ་བཤེར་འཚོལ།

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

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

# Chagency

 རྩོམ་པ་པོ། [Jordy Meow](https://profiles.wordpress.org/tigroumeow/)

[ཕབ་ལེན།](https://downloads.wordpress.org/plugin/chagency.0.0.4.zip)

 * [ཞིབ་ཕྲ།](https://bo.wordpress.org/plugins/chagency/#description)
 * [གདེང་འཇོག](https://bo.wordpress.org/plugins/chagency/#reviews)
 * [ཡར་རྒྱས།](https://bo.wordpress.org/plugins/chagency/#developers)

 [རམ་འདེགས།](https://wordpress.org/support/plugin/chagency/)

## ཞིབ་བརྗོད།

**Chagency** is the first chatbot to ship directly on top of the new AI Client introduced
in WordPress 7.0 — `wp_ai_client_prompt()`, Connectors, and the Abilities API. Every
prompt flows through WordPress core, every provider is a Connector you already configured
under **Settings  Connectors**, and every action it exposes is a registered Ability
that other plugins (and other AI agents) can call.

There is no other plugin on wordpress.org that builds on `wp_ai_client_prompt()`
today. Chagency is the reference case: a small, native chatbot that proves the framework
works, ships zero vendor SDKs, and grows alongside the Abilities API into a real
agent.

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 turns into an agent tomorrow, without a rename.

### 🪨 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.

## གཏུབ་རེིས།

 * [[
 * The floating chat panel open on an admin page, native WP 7 Gutenberg look.
 * [[
 * The settings screen under **Settings  Chagency**, with per-provider _Test_ buttons.
 * [[

## གདེང་འཇོག

![](https://secure.gravatar.com/avatar/7fd0db6b7cc94854050dc68325a632244c35e2b497fede26f1b3631c79f5821e?
s=60&d=retro&r=g)

### 󠀁[The 1st and only chatbot to use the AI Client](https://wordpress.org/support/topic/the-1st-and-only-chatbot-to-use-the-ai-client/)󠁿

 [Jordy Meow](https://profiles.wordpress.org/tigroumeow/) 2026 ལོའི་ཟླ 6 ཚེས 4 ཉིན།

Nobody cares. Or maybe some do. I do! 😼 The first and only chatbot (as of today)
to use the AI Client that ships with WordPress (from v7). This chatbot is perfect
for testing the AI Client and the AI providers built for it.

 [ གདེང་འཇོག 1 ཡོངས་སུ་ཀློག ](https://wordpress.org/support/plugin/chagency/reviews/)

## བྱས་རྗེས་འཇོག་མཁན། & གསར་འབྱེད་པ།

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

བྱས་རྗེས་འཇོག་མཁན།

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

[ཁྱེད་ཀྱི་སྐད་ཡིག་ནང་ལ་ “Chagency” ཡིག་སྒྱུར་བྱོས།](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).

## དག་བཅོས་ཉིན་ཐོ།

#### 0.0.4 (2026/06/03)

 * Fix: Chat launcher now appears when the AI provider key is set via an environment
   variable or constant, not only when saved through the settings page.

#### 0.0.3 (2026/05/22)

 * Update: Rebuilt plugin against the WP 7 AI plugin toolchain.
 * Update: Sharpened wordpress.org positioning.

#### 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.

## ཟུར་བརྗོད།

 *  Version **0.0.4**
 *  Last updated **ཉིན 2 སྔོན།**
 *  Active installations **ཐེངས་ 10 ལས་ཉུང་བ།**
 *  WordPress version ** 7.0 ཡང་ན་དེ་ལས་མཐོ་བ། **
 *  Tested up to **7.0**
 *  PHP version ** 7.4 ཡང་ན་དེ་ལས་མཐོ་བ། **
 *  Language
 * [English (US)](https://wordpress.org/plugins/chagency/)
 * Tags
 * [abilities](https://bo.wordpress.org/plugins/tags/abilities/)[agent](https://bo.wordpress.org/plugins/tags/agent/)
   [AI](https://bo.wordpress.org/plugins/tags/ai/)[chatbot](https://bo.wordpress.org/plugins/tags/chatbot/)
   [connectors](https://bo.wordpress.org/plugins/tags/connectors/)
 *  [མཐོ་རིམ་མཐོང་སྣང་།](https://bo.wordpress.org/plugins/chagency/advanced/)

## གདེང་འཇོག

 5 out of 5 stars.

 *  [  1 5-star review     ](https://wordpress.org/support/plugin/chagency/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/chagency/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/chagency/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/chagency/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/chagency/reviews/?filter=1)

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

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

## བྱས་རྗེས་འཇོག་མཁན།

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

## རམ་འདེགས།

Got something to say? Need help?

 [རམ་འདེགས་གླེང་སྟེགས་ལ་ལྟ།](https://wordpress.org/support/plugin/chagency/)