Title: OctoPress Author: Nazmul Alam Published: June 17, 2026 Last modified: June 17, 2026 --- Search plugins ![](https://ps.w.org/octopress/assets/icon-256x256.png?rev=3576053) # OctoPress By [Nazmul Alam](https://profiles.wordpress.org/nazmulpcc/) [Download](https://downloads.wordpress.org/plugin/octopress.0.4.1.zip) * [Details](https://wordpress.org/plugins/octopress/#description) * [Reviews](https://wordpress.org/plugins/octopress/#reviews) * [Installation](https://wordpress.org/plugins/octopress/#installation) * [Development](https://wordpress.org/plugins/octopress/#developers) [Support](https://wordpress.org/support/plugin/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 ``` ## Screenshots [⌊OctoPress chat workspace with agent, provider, and model selection.⌉⌊OctoPress chat workspace with agent, provider, and model selection.⌉[ OctoPress chat workspace with agent, provider, and model selection. [⌊Agent selector with Octo and Block Content Builder profiles.⌉⌊Agent selector with Octo and Block Content Builder profiles.⌉[ Agent selector with Octo and Block Content Builder profiles. [⌊Native input request modal for clarifying requirements.⌉⌊Native input request modal for clarifying requirements.⌉[ Native input request modal for clarifying requirements. [⌊Tool permission request modal for approval-gated actions.⌉⌊Tool permission request modal for approval-gated actions.⌉[ Tool permission request modal for approval-gated actions. [⌊Native plan confirmation modal before implementation work.⌉⌊Native plan confirmation modal before implementation work.⌉[ Native plan confirmation modal before implementation work. [⌊Summarized tool result rendered in the chat transcript.⌉⌊Summarized tool result rendered in the chat transcript.⌉[ Summarized tool result rendered in the chat transcript. [⌊First-run onboarding readiness check.⌉⌊First-run onboarding readiness check.⌉[ First-run onboarding readiness check. [⌊First-run onboarding provider setup.⌉⌊First-run onboarding provider setup.⌉[ First-run onboarding provider setup. [⌊System prompt settings.⌉⌊System prompt settings.⌉[ System prompt settings. [⌊Agent profile settings with configurable default agent.⌉⌊Agent profile settings with configurable default agent.⌉[ Agent profile settings with configurable default agent. [⌊Tool settings grouped by capability and policy.⌉⌊Tool settings grouped by capability and policy.⌉[ Tool settings grouped by capability and policy. [⌊Skill settings for prompt/context resources.⌉⌊Skill settings for prompt/context resources.⌉[ Skill settings for prompt/context resources. [⌊Extension settings for enabling feature bundles.⌉⌊Extension settings for enabling feature bundles.⌉[ Extension settings for enabling feature bundles. ## Installation 1. Upload the `octopress` folder to `/wp-content/plugins/`, or install the plugin ZIP from WordPress admin. 2. Activate OctoPress from the Plugins screen. 3. Open OctoPress in WordPress admin. 4. Complete onboarding by configuring at least one AI provider. 5. Sync provider models and enable the model you want to use. 6. Open the chat workspace and start a new chat. ## FAQ ### Does OctoPress include an AI model? No. OctoPress is a WordPress-hosted workspace and orchestration layer. You connect it to an AI provider and model using your own provider account or endpoint. ### Which providers are supported? OctoPress supports OpenAI Platform, OpenAI OAuth, OpenAI Responses-compatible providers, and OpenAI Chat Completions-compatible providers. Some third-party providers may work through compatibility modes when their APIs match the expected format. ### What data is stored in WordPress? OctoPress stores provider configuration, encrypted provider secrets, chats, messages, runs, settings, agent profiles, tool settings, skill settings, and extension settings in your WordPress database. ### Are API keys exposed to browser users? No. Provider secrets are stored server-side and are not returned in normal browser- facing REST responses. ### Can OctoPress update WordPress content? Yes, but only through enabled tools and permissions. Content-writing workflows are designed around drafts or explicit user-approved updates. Approval-gated actions require confirmation unless the chat has been configured for auto approval. ### Does OctoPress work without a provider? You can activate the plugin and open onboarding, but chat workflows require at least one configured provider with an enabled model. ### Does OctoPress run on cPanel hosting? Yes, when the hosting account allows normal WordPress loopback HTTP requests to the site’s own REST API. The free plugin does not require shell/process execution. If a host blocks loopback requests or disables WP-Cron without a replacement cron job, long-running chat workflows may not continue reliably. ### Where can I get support? Use the WordPress.org support forum for the free OctoPress plugin. ### What is the difference between free features and extensions? The free plugin includes the core AI workspace, provider setup, agents, block editor content support, permissions, and extension infrastructure. Optional first-party or third-party extensions may add more tools, agents, skills, or integrations. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “OctoPress” is open source software. The following people have contributed to this plugin. Contributors * [ Nazmul Alam ](https://profiles.wordpress.org/nazmulpcc/) [Translate “OctoPress” into your language.](https://translate.wordpress.org/projects/wp-plugins/octopress) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/octopress/), check out the [SVN repository](https://plugins.svn.wordpress.org/octopress/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/octopress/) by [RSS](https://plugins.trac.wordpress.org/log/octopress/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 0.4.1 * Hardened chat REST permissions so chat reads and message creation verify ownership before returning or writing private conversation data. * Added direct WordPress capability checks immediately before content creation and content update tool writes. * Added a privacy policy helper and administrator-only Data Control setting for deleting OctoPress data on uninstall. * Added uninstall cleanup for OctoPress custom tables and core options when Data Control cleanup is enabled. * Added package metadata and compatibility cleanup for WordPress.org review, including Text Domain, GPL license file, and direct-access guards. * Improved use of WordPress core helpers for JSON parsing, excerpts, plugin activation checks, and core skill caching. #### 0.4.0 * Replaced shell-spawned background processing in the free package with a WordPress- native request-tick runtime. * Added WP-Cron watchdog recovery for abandoned request-tick runs. * Removed free-package dependence on PHP CLI and shell/process execution. * Added a Stop action for active chat runs. * Aligned internal loopback HTTP requests with WordPress HTTP API SSL verification defaults. ## Meta * Version **0.4.1** * Last updated **14 hours ago** * Active installations **Fewer than 10** * WordPress version ** 6.0 or higher ** * Tested up to **7.0** * PHP version ** 8.1 or higher ** * Tags * [AI](https://wordpress.org/plugins/tags/ai/)[artificial intelligence](https://wordpress.org/plugins/tags/artificial-intelligence/) [content](https://wordpress.org/plugins/tags/content/)[gutenberg](https://wordpress.org/plugins/tags/gutenberg/) [workflow](https://wordpress.org/plugins/tags/workflow/) * [Advanced View](https://wordpress.org/plugins/octopress/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/octopress/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/octopress/reviews/) ## Contributors * [ Nazmul Alam ](https://profiles.wordpress.org/nazmulpcc/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/octopress/)