OctoPress

Description

OctoPress adds an AI workspace inside WordPress admin. It lets site administrators configure their own AI providers, choose models, chat with agent profiles, and use WordPress-aware tools for content and site workflows.

The free plugin focuses on a safe foundation for AI-assisted WordPress work:

• First-run onboarding for provider setup and readiness checks.
• Admin chat workspace with saved chats and per-chat model/agent selection.
• Configurable AI providers, including OpenAI Platform, OpenAI OAuth, OpenAI Responses-compatible providers, and OpenAI Chat Completions-compatible providers.
• Agent profiles with configurable prompts, skills, handoff behavior, and a default agent for new chats.
• Permission controls for approval-gated tool calls.
• Block editor content tools for inspecting blocks, patterns, theme design tokens, and composing draft content.
• Extension architecture for additional first-party or third-party capabilities.

OctoPress stores its operational data in your WordPress database and runs from your WordPress admin. It does not include an AI model. You connect it to the provider and model you choose.

Runtime requirements

OctoPress requires PHP 8.1 or newer and working WordPress HTTP loopback requests to its own REST API. The free WordPress.org build uses WordPress-native request ticks for agent runs and WP-Cron as a recovery watchdog. It does not require PHP CLI access, shell access, exec(), shell_exec(), pcntl_fork(), or posix_setsid().

Some hosts block loopback HTTP requests or disable WP-Cron. In those environments OctoPress can activate, but chat runs may not continue reliably until loopback requests to the same WordPress site are allowed. Sites with disabled WP-Cron should configure a real server cron for wp-cron.php, as recommended by WordPress hosting documentation.

External services

OctoPress can send requests to external AI providers after an administrator configures a provider and uses model sync, chat, or an AI-assisted workflow. Depending on the action, data sent to the configured provider may include prompts, chat messages, selected WordPress content, tool context, model names, provider metadata, and generated responses.

Built-in provider options include OpenAI services:

• OpenAI terms: https://openai.com/policies/terms-of-use/
• OpenAI privacy policy: https://openai.com/policies/privacy-policy/

OctoPress also supports custom OpenAI-compatible endpoints. If you configure a custom provider, that provider receives the request data for the models you use. Review that provider’s terms, privacy policy, and data handling practices before connecting it.

API keys and OAuth credentials are stored server-side in WordPress and are not returned to browsers by OctoPress REST responses.

Development source

OctoPress includes compiled admin JavaScript and CSS in assets/admin/dist. The human-readable admin frontend source is included in assets/admin/src, with build configuration in package.json, package-lock.json, vite.config.ts, and tsconfig.json.

To rebuild the admin assets from source:

npm install
npm run build
composer install