OctoPress

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 Block Content Builder 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.
• 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.
• 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.