=== Agenistrator – AI Agent & Assistant for WordPress Admin ===
Contributors: maximumsoftware
Donate link: https://github.com/sponsors/maximum-software
Tags: ai, ai-agent, automation, openai, assistant
Requires at least: 5.3
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.3
License: GPL-3.0-only
License URI: https://www.gnu.org/licenses/gpl-3.0.html

AI agent for WordPress admin. Chat to manage your site, create content and automate tasks. Try free models to get started.

== Description ==

https://youtu.be/F13mFPAZnsA

**Agenistrator puts an AI agent directly in your WordPress admin dashboard.** Most AI plugins just generate text in a box. Agenistrator actually operates your admin for you. Chat naturally to manage your entire site: create and edit content, install plugins and themes, manage users and permissions, monitor site health, and automate multi-step workflows. The agent plans complex tasks, executes them step by step, and course-corrects if it gets stuck. It's read-only by default, so it can't change anything until you explicitly approve write access.

= Try It for Free =

You can start using Agenistrator at no cost. OpenRouter and Ollama Cloud both offer free tiers with capable models. Just sign up, get a free API key, and you're ready to go. No credit card required to get started.

= What Makes Agenistrator Different =

* **True AI agent, not just a chatbot.** The assistant doesn't just answer questions, it plans and executes multi-step tasks autonomously. Tell it "find every draft post older than a year and publish them" and it figures out the steps, runs them, and reports back.
* **Survives long-running tasks.** Works around PHP execution-time limits and provider rate limits without losing progress, so big multi-step jobs actually finish instead of timing out.
* **Over 100 built-in tools.** Manage posts, pages, comments, media, users, plugins, themes, menus, settings, cron jobs, and more, all through natural language. Each tool can be individually enabled or disabled.
* **Smart context management.** Counts tokens in real time, detects model context limits, prunes old messages, and loads tools only when needed, keeping long conversations on track and efficient.
* **Secure PHP sandbox.** Run calculations and data transformations against a whitelist of safe functions, with no access to the rest of your system.
* **Works with your preferred AI provider.** OpenAI, Anthropic (Claude), OpenRouter (hundreds of models), and Ollama Cloud. Configure multiple providers and switch between them anytime.
* **Safety-first by default.** Read-only tools are enabled out of the box. Write tools that modify your site must be explicitly activated by you. The agent respects WordPress permissions and multisite boundaries.
* **Optional semantic search.** Enable embeddings to let the agent find content by meaning, not just keywords. Disabled by default to avoid surprise costs. The plugin works great without it.
* **Your data stays private.** Conversations and settings are stored in your WordPress database. Content is only sent to AI providers you explicitly configure.

= What You Can Do =

* Create, edit, and search posts, pages, and custom post types
* Manage comments, categories, tags, and custom taxonomies
* Upload and organize media files
* Create and manage users, roles, and permissions
* Search, install, activate, and update plugins and themes
* Build and organize navigation menus
* Configure site options and monitor site health
* Manage WP-Cron jobs and Action Scheduler tasks
* Send emails, fetch web content, and download files
* Read debug logs and diagnose issues
* Run calculations and data transformations in a secure sandbox
* Write and delete files in your uploads directory (power users)

= Getting Started in 2 Minutes =

1. Install and activate the plugin, and a chat icon appears in your admin
2. Go to **Agenistrator > Settings** and add a provider
3. **Free option:** Sign up for OpenRouter (openrouter.ai) or Ollama Cloud (ollama.com), get a free API key, and paste it in
4. Select a chat model (a sensible default is auto-selected)
5. Click the chat icon and start delegating tasks

= Safety & Transparency =

Agenistrator gives AI models the ability to make changes to your site. We take this responsibility seriously:

* **Read-only by default.** Tools that modify data are disabled until you explicitly enable them.
* **Permission-aware.** The agent can only do what your WordPress user account is allowed to do.
* **Multisite-safe.** Sensitive tools are restricted to super admins. Site admins cannot access data from other sites in the network.
* **Model quality matters.** More capable models produce better results. If you're not getting the output you expect, try a more powerful model.

**Please be aware:** Using AI agents carries inherent risks, including potential API costs, unintended content changes, and data loss. Start with a spending limit on your provider account. The developers accept no responsibility for actions taken by AI models through this plugin. Use at your own risk.

== Privacy & Data ==

* **What is stored locally (in your WordPress database):**
  * Your API keys (stored securely in your WordPress database)
  * Your chat history with the assistant
  * Content embeddings (if enabled)
  * All plugin settings and configuration
* **What is sent to your AI provider:**
  * Your conversation history
  * Tool call output (can contain your data)
  * Site pages and posts (only if you enable semantic search)

Some tools can fetch external URLs or send emails if you enable them.

== External Services ==

This plugin connects to external services to provide AI assistant functionality. **You must configure at least one AI provider** for the plugin to work. Your conversations and site content are only sent to providers you explicitly configure.

* **OpenAI**: Chat and embedding models. [Terms](https://openai.com/policies/terms-of-use) | [Privacy](https://openai.com/privacy)
* **Anthropic (Claude)**: Chat models only (no embeddings). [Terms](https://www.anthropic.com/legal) | [Privacy](https://www.anthropic.com/privacy)
* **OpenRouter**: Access to hundreds of models from multiple providers through a single API key. [Terms](https://openrouter.ai/terms) | [Privacy](https://openrouter.ai/privacy)
* **Ollama Cloud**: Hosted open-weight models with a free tier. Chat only (no embeddings). [Terms](https://ollama.com/terms) | [Privacy](https://ollama.com/privacy)

**Data sent to providers:** Your conversation history, tool outputs, and relevant site content are sent when you interact with the assistant. If you enable semantic search, your site's posts and pages are sent to generate embeddings.

**Other external requests:** The plugin fetches model metadata from models.dev ([GitHub](https://github.com/anomalyco/models.dev)) and tokenizer vocabulary files from OpenAI's public blob storage. These requests contain only your server's IP address and no user data. Both are cached locally.

== Requirements ==

* WordPress 5.3 or higher
* PHP 7.4 or higher
* MySQL 5.7.8+ or MariaDB 10.2.7+
* An API key from OpenAI, Anthropic, OpenRouter, or Ollama Cloud
* Administrator access (the plugin is only available to administrators)

**Multisite:** Site administrators can manage their own sites. Tools that read files outside the uploads directory or access server-level diagnostics require super admin access.

== Installation ==

1. Install and activate the plugin through the WordPress plugins screen, or upload the zip file to `/wp-content/plugins/agenistrator`
2. A chat icon will appear in the corner of your WordPress admin area
3. Go to **Agenistrator > Settings** to configure your AI provider and select a model
4. (Optional) Enable semantic search by selecting an embedding model
5. Customize which tools are enabled based on your needs
6. Click the chat icon and start chatting with your AI assistant

== Frequently Asked Questions ==

= How much does this cost? =

Agenistrator itself is free. However, it requires an API key from an AI provider (OpenAI, Anthropic, OpenRouter, or Ollama Cloud), which typically charge based on usage. Costs vary by provider and model, and more capable models generally cost more per message. Start with a spending limit on your provider account to avoid surprises. Ollama Cloud and OpenRouter both offer free tiers that let you try the plugin without any cost.

= Will this break my website? =

Agenistrator is designed with safety in mind. By default, only read-only tools are enabled, so the assistant can view and search your content but cannot make changes. Write tools (that create, edit, or delete content) must be explicitly enabled by you. The assistant also respects WordPress permissions, so it can only do what your user account is allowed to do.

= Can I undo changes the assistant makes? =

Changes made by Agenistrator are the same as changes you would make manually through WordPress. Posts and pages support WordPress revisions, so you can revert content changes. For other operations, consider making a backup before enabling write tools for the first time.

= What AI models does this plugin support? =

Agenistrator works with any compatible model from OpenAI, Anthropic (Claude), OpenRouter, or Ollama Cloud. Available models are automatically discovered from each provider. The plugin filters out models that don't support the features it needs, showing you only compatible options.

= Why isn't the assistant giving good results? =

More capable models generally provide better results for complex tasks. If you're using a smaller or free-tier model and experiencing issues, try switching to a more powerful model. The quality of your results is directly related to the capabilities of the AI model you choose.

= What is semantic search? =

Semantic search finds content by meaning rather than just keywords. For example, searching for "vacation photos" could find a post titled "Our Trip to Hawaii" even though the exact words don't match. This feature is optional and requires an embedding model from OpenAI or OpenRouter (Anthropic and Ollama Cloud don't offer embedding models). Semantic search is disabled by default to avoid surprise API costs.

= Is my data safe? =

Your API keys, chat history, and content embeddings are stored in your WordPress database and are not transmitted externally by the plugin. When you chat with the assistant, your messages and relevant context are sent to your configured AI provider. The plugin also fetches model metadata from models.dev and tokenizer data (both cached locally).

= What permissions does the assistant have? =

The assistant can only perform actions that:
1. You have enabled in the tool settings (read-only tools are on by default, write tools are off)
2. Your WordPress user account has permission to do
3. Are implemented as tools in the plugin

= How do I get started? =

1. Sign up for an account with OpenAI, Anthropic, OpenRouter, or Ollama Cloud
2. Get your API key from their dashboard
3. Go to **Agenistrator > Settings** in WordPress
4. Add your provider and enter your API key
5. Select a chat model and start chatting!

**Tip**: For a free, easy-to-set-up starting point, try Ollama Cloud. A sensible default chat model is auto-selected when you add the provider. OpenRouter is another good free option that gives you access to hundreds of models from multiple providers with a single API key.

= Can I use multiple AI providers? =

Yes! You can configure multiple providers and switch between them. This is useful for comparing models or using different providers for different tasks.

= How do I report a problem? =

You can generate a diagnostic report directly from the chat widget. Reports include your chat thread, site info, and configuration (API keys are automatically excluded). You can download reports for your own review or optionally send them to help developers fix issues. For direct support, use the WordPress.org support forum.

== Screenshots ==

1. Animated GIF showing the chat interface accepting natural language commands and performing tasks
2. Status dashboard showing configured AI models, embeddings count, and available tools overview
3. Provider settings with multiple AI providers configured
4. Model selection for chat and embeddings with recommendations and context window settings
5. Tool management interface showing read-only and read-write tools with enable/disable controls
6. Embeddings management for semantic search with sync controls
7. UI settings with chat position selector and the floating chat widget

== Changelog ==

= 1.0.3 =

* Release date: June 5, 2026

* Translation fixes and corrections
* Refactored readme
* Updated dependencies

= 1.0.2 =

* Release date: May 19, 2026

* Minor fixes and improvements

= 1.0.1 =

* Release date: May 5, 2026

* Added Ollama Cloud provider support
* Added Write File and Delete File tools (restricted to uploads and temp directories)
* Semantic search is now gracefully disabled on unsupported databases
* Temperature parameter now selectively sent only when supported
* Merged Upload Media and Download Media into a single Create Media tool
* Improved settings page onboarding and provider labels
* Security: sanitized API keys before sending to APIs in HTTP headers
* Fixed OpenRouter defaulting to Free Models Router for first-time no-cost setup
* Other fixes and improvements

= 1.0.0 =

* Release date: March 8, 2026

* Initial release
