Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/optistack-web/optistack-agent-bridge/archive/refs/heads/main.zipNo built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Make your WordPress site fully readable by AI agents, LLMs, and coding assistants.
OptiStack Agent Bridge exposes your WordPress content through the llms.txt standard and a clean Markdown REST API — so tools like ChatGPT, Claude, Cursor, and Windsurf can natively understand and query your site.
✨ Features
/llms.txtendpoint — Auto-generated, spec-compliant index of your site content for AI crawlers/llms-full.txtendpoint — Extended version with post excerpts- REST API —
/wp-json/ai/v1/postsreturns clean, HTML-stripped text ready for LLM consumption - React Admin UI — Built with
@wordpress/scripts(in progress) - Zero config — Works out of the box on activation
🗺️ Roadmap
See ROADMAP.md for the full development plan.
Current phase: Phase 1 — Core Foundation & Settings
🚀 Installation
From Source
cd wp-content/plugins
git clone https://github.com/optistack-web/optistack-agent-bridge.git
cd optistack-agent-bridge
npm install && npm run build
Then activate the plugin from WordPress Admin → Plugins.
Requirements
- WordPress 6.2+
- PHP 7.4+
- Node.js 18+ (for building the admin UI)
🔌 Usage
llms.txt
Once activated, your site automatically serves:
https://yoursite.com/llms.txt
https://yoursite.com/llms-full.txt
Example output:
# My WordPress Site
> A site about web development and design.
## Recent Posts
- [Hello World](https://yoursite.com/hello-world): A brief intro post...
- [Getting Started](https://yoursite.com/getting-started): How to begin...
## Optional
- [Full Content Index](https://yoursite.com/llms-full.txt): Complete content with excerpts.
REST API
# Get all posts (clean text, no HTML)
GET /wp-json/ai/v1/posts
# Search posts
GET /wp-json/ai/v1/posts?search=wordpress
Example response:
[
{
"id": 1,
"title": "Hello World",
"url": "https://yoursite.com/hello-world",
"date": "2026-01-01 00:00:00",
"content": "Welcome to WordPress. This is your first post...",
"excerpt": "Welcome to WordPress..."
}
]
🏗️ Architecture
optistack-agent-bridge/
├── optistack-agent-bridge.php # Plugin bootstrap
├── package.json # @wordpress/scripts config
└── includes/
├── class-admin.php # Admin menu + React app enqueue
├── class-rewrites.php # URL routing (llms.txt, llms-full.txt)
├── class-markdown-generator.php # Markdown generation engine
└── class-rest-api.php # REST API controller
Design principles:
- Single-responsibility classes
- Dependency injection
- Namespace
WPAgentBridge\Inc - WordPress Coding Standards compliant
🛠️ Development
npm install # Install dependencies
npm run start # Dev server with hot reload
npm run build # Production build
📄 License
GPL-2.0-or-later — see LICENSE file.