OctoberCMS Plugin for Claude Code

Show and Tell
,
#1

Hi everyone,

I’ve been working on a plugin for Claude Code that helps it understand OctoberCMS conventions and documentation. Sharing the first version here.

What it does

When using Claude Code for OctoberCMS development, this plugin gives Claude access to version-specific documentation and coding standards. It auto-detects which version you’re using (1.x through 4.x) and loads the relevant docs.

Installation

Start a new claude session and do:

/plugin marketplace add softappstudio/octobercms-claude-plugin
/plugin install octobercms@softappstudio
/octobercms:setup

That’s it.

image
image688×706 17.4 KB

Current Features

  • Auto-detects OctoberCMS version via php artisan october:about
  • Downloads documentation on-demand (only what you need)
  • Syncs doc updates automatically on session start
  • Includes basic development guidance (artisan commands, naming conventions)

Commands

  • /octobercms:setup - Initial setup
  • /octobercms:sync-docs - Manual doc sync
  • /octobercms:october-version - Switch versions
  • /octobercms:update-settings - Configure sync behavior

GitHub

GitHub - softappstudio/octobercms-claude-plugin

What’s next

This is a foundation. Lots of room to grow - specialized agents for specific tasks, additional knowledge sources, etc.

Would love to hear what would be most useful for your workflow.

6 Likes
#2

It just wrote a handful of blueprints for me for testing, and it worked flawlessly. 10/10 would recommend!

One issue:

  • It thinks tailor:refresh (destroy all data) is the same thing as tailor:migrate (migrate blueprints) … maybe we need to rename this? :sweat_smile:
1 Like
#3

This is fantastic. Just installed the plugin this morning and I can already see Claude adhering much more to default October CMS patterns. This helps enormously with development. Thank you very much!!

1 Like
#4

@chocolata thank you for the feedback :slight_smile:

#5

v1.1.0 — Community Answers

New version adds 530+ solved topics from the OctoberCMS forum as a searchable
knowledge base.

The docs explain how each feature works. But real projects combine them, and
that’s where things get tricky — repeaters inside mixins, multisite with Static
Pages, mergeConfig with tabbed fields. The plugin now searches 530+ solved forum
topics alongside the official documentation.

Upgrade to v1.1.0

claude plugin marketplace update softappstudio
claude plugin update octobercms@softappstudio
/octobercms:setup

Screenshot from 2026-02-01 23-23-57
Screenshot from 2026-02-01 23-23-57910×373 50.4 KB

What’s new

  • Community answers knowledge base (need-help, questions, tips-and-tricks,
    known-issues)
  • Broader skill triggering (plugin, component, tailor, blueprint, and more)
  • Community answers sync on session start alongside docs
  • Per-project toggle to enable/disable community answers

Example

Prompt: my mergeConfig with tabbed fields only renders one of the two configs

image
image1376×576 108 KB

Claude finds the answer from the forum (answered by @daftspunk), cites the source,
and explains that mergeConfig uses a non-recursive merge — with the fix using
makeConfig and manually merging tabs[‘fields’].

2 Likes