Title: OctoPress
Author: Nazmul Alam
Published: <strong>June 17, 2026</strong>
Last modified: July 6, 2026

---

Search plugins

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

![](https://ps.w.org/octopress/assets/icon-256x256.gif?rev=3581716)

# OctoPress

 By [Nazmul Alam](https://profiles.wordpress.org/nazmulpcc/)

[Download](https://downloads.wordpress.org/plugin/octopress.0.5.1.zip)

 * [Details](https://vec.wordpress.org/plugins/octopress/#description)
 * [Reviews](https://vec.wordpress.org/plugins/octopress/#reviews)
 *  [Installation](https://vec.wordpress.org/plugins/octopress/#installation)
 * [Development](https://vec.wordpress.org/plugins/octopress/#developers)

 [Support](https://wordpress.org/support/plugin/octopress/)

## Description

OctoPress brings AI chat and agent workflows into WordPress admin. You connect the
AI account or provider you want to use, keep chats in WordPress, and stay in control
of content changes with questions, plans, and approvals.

#### What OctoPress helps you do

 * Use your own AI account or API provider instead of being locked into one hosted
   service.
 * Sign in with ChatGPT or connect an API provider such as OpenAI, DeepSeek, OpenRouter,
   OpenCode Go, ZAI, or a custom compatible endpoint.
 * Keep saved AI chats inside WordPress admin.
 * Choose focused agents such as Octo or Content Writer for different types of work.
 * Let agents ask questions or propose plans before continuing.
 * Review approval requests before content changes are made.
 * Work with WordPress content using site-aware tools.
 * Attach images to chats when the selected model supports image input.
 * Preview and reuse chat images in later messages.
 * Retry a failed turn with your current provider, model, and agent selection.
 * Update WordPress content with approval-gated changes such as slug, status, categories,
   tags, and featured image.
 * Use native WooCommerce abilities when WooCommerce is active and exposes them.

#### How it works

OctoPress runs inside WordPress admin. You connect your AI account or API provider,
sync available models, enable the model you want, and start chatting.

When an agent needs information from WordPress, OctoPress can provide safe site 
context such as posts, pages, public post types, plugins, themes, blocks, patterns,
theme design settings, and available WordPress abilities. When an agent wants to
change content, OctoPress uses enabled tools and permission checks so you can stay
in control.

OctoPress does not include an AI model. The AI responses come from the provider 
you choose.

#### What is included

 * First-run onboarding for provider setup and readiness checks.
 * A saved chat workspace in WordPress admin.
 * Provider setup for ChatGPT sign-in, OpenAI API keys, compatible API providers,
   and custom endpoints.
 * Agent profiles with editable prompts, skills, handoff behavior, and a default
   agent for new chats.
 * Native question, plan review, handoff, and approval flows.
 * Permission controls for actions that should require confirmation.
 * Content tools for inspecting WordPress content, blocks, patterns, theme colors,
   typography, spacing, and draft content.
 * Image-aware chat attachments, image preview, and reuse for compatible models.
 * Media Library save actions for selected OctoPress chat images.
 * Failed-turn retry support for recovering from provider or runtime errors.
 * Model capability handling so image controls are shown only when the selected 
   model supports image input.
 * Native WooCommerce ability support when WooCommerce is active and exposes abilities.
 * Extension support so additional tools, skills, and agents can be added later.

#### Your data and credentials

OctoPress stores its settings, provider configuration, encrypted provider secrets,
chats, messages, runs, agents, tools, skills, and extension settings in your WordPress
database.

API keys and OAuth credentials are stored server-side and are not returned to browser
users through normal OctoPress REST responses.

#### Hosting requirements

OctoPress requires PHP 8.1 or newer. For long chats to continue reliably, your host
must allow normal WordPress loopback requests to the same site. The free plugin 
does not require PHP CLI access, shell access, or server process execution.

Some hosts block loopback requests or disable WP-Cron. In those environments OctoPress
can activate, but long-running chats may not continue reliably until loopback requests
are allowed. Sites with disabled WP-Cron should configure a real server cron for`
wp-cron.php`.

#### Admin app source files

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

### Optional External Services

OctoPress does not contact AI providers automatically. A provider is contacted only
after an administrator selects and configures that provider, then uses model sync,
chat, or an AI-assisted workflow with that provider.

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 presets include:

 * OpenAI / ChatGPT: Terms https://openai.com/policies/row-terms-of-use/ – Privacy
   https://openai.com/policies/row-privacy-policy/
 * DeepSeek: Terms https://cdn.deepseek.com/policies/en-US/deepseek-open-platform-
   terms-of-service.html – Privacy https://cdn.deepseek.com/policies/en-US/deepseek-
   privacy-policy.html
 * OpenRouter: Terms https://openrouter.ai/terms – Privacy https://openrouter.ai/
   privacy
 * OpenCode Go: Terms https://opencode.ai/legal/terms-of-service – Privacy https://
   opencode.ai/legal/privacy-policy
 * ZAI / ZAI Coding Plan: Terms https://docs.z.ai/legal-agreement/terms-of-use –
   Privacy https://docs.z.ai/legal-agreement/privacy-policy

OctoPress also supports custom provider endpoints. If you configure a custom provider,
review that provider’s terms, privacy policy, and data handling practices before
connecting it.

## 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 Content Writer profiles.⌉⌊Agent selector with Octo
and Content Writer profiles.⌉[

Agent selector with Octo and Content Writer 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 admin workspace. You connect it to the AI account, 
API provider, or compatible endpoint you want to use.

### Can I use my existing AI subscription?

Yes, when the provider supports it. ChatGPT sign-in lets you connect a ChatGPT account
instead of entering an OpenAI API key. API-key providers use their own account, 
billing, and usage rules.

### Which providers are supported?

OctoPress supports ChatGPT sign-in, OpenAI API keys, ZAI Coding Plan, DeepSeek, 
OpenCode Go, compatible API providers, and custom endpoints. The provider setup 
wizard includes presets for several popular providers, and advanced users can add
their own compatible endpoint.

### What data is stored in WordPress?

OctoPress stores provider configuration, encrypted provider secrets, chats, messages,
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 you configure that chat to approve selected actions 
automatically.

### Can I use images in chat?

Yes, when the selected model supports image input. OctoPress supports PNG, JPEG,
WebP, and GIF image attachments, lets you preview and reuse chat images, and can
save selected OctoPress chat images to the WordPress Media Library.

### What happens if a chat run fails?

OctoPress can retry the latest failed turn without duplicating your original message.
The retry uses your current provider, model, and agent selection, so you can adjust
those settings before trying again.

### Does OctoPress work with WooCommerce?

OctoPress can expose native WooCommerce abilities when WooCommerce is active and
those abilities are available on the site. The plugin can use WooCommerce’s own 
supported abilities through the OctoPress tool and approval system.

### 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 requests to the same
site. The free plugin does not require shell or process execution. If a host blocks
loopback requests or disables WP-Cron without a replacement cron job, long-running
chats may not continue reliably.

### Where can I get support?

Use the WordPress.org support forum for the free OctoPress plugin.

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

 * Added image attachments for compatible vision models.
 * Added image preview, reuse, and Media Library save actions.
 * Added Retry for failed chat turns.
 * Expanded approval-gated content updates with slug, status, taxonomy, and featured
   image support.
 * Added compact block content outlines and section zooming for focused long-content
   edits.
 * Improved block content patching so sections can be replaced, inserted, or removed
   with stale-content checks.
 * Improved long-form content handling on hosts with tight request timeouts by guiding
   agents to write smaller sections incrementally.
 * Improved provider/model capability detection and filtered unsupported OpenAI 
   API models.
 * Improved attachment validation and WordPress.org Plugin Check compatibility.

#### 0.4.2

 * Added a guided provider connection wizard with presets for ChatGPT, OpenAI API,
   DeepSeek, OpenRouter, OpenCode Go, and ZAI.
 * Improved provider model management with searchable synced models and clearer 
   enable/default controls.
 * Added more built-in free guidance skills for content planning, content refresh,
   accessibility/readability, WordPress site management, and WooCommerce content
   help.
 * Improved long chat handling with automatic context compaction and visible context
   usage.
 * Improved chat message loading and provider setup UI polish.
 * Updated the WordPress.org readme and plugin page assets to better explain available
   features.

## Meta

 *  Version **0.5.1**
 *  Last updated **2 days ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.0 or higher **
 *  Tested up to **7.0**
 *  PHP version ** 8.1 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/octopress/)
 * Tags
 * [AI](https://vec.wordpress.org/plugins/tags/ai/)[artificial intelligence](https://vec.wordpress.org/plugins/tags/artificial-intelligence/)
   [content](https://vec.wordpress.org/plugins/tags/content/)[gutenberg](https://vec.wordpress.org/plugins/tags/gutenberg/)
   [workflow](https://vec.wordpress.org/plugins/tags/workflow/)
 *  [Advanced View](https://vec.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/)