Quickstart

Two commands to install, one interview to set up, and a first audit of any public site in about 10 minutes with zero credentials. Add GA4, GSC, WordPress, and an approval channel as you get comfortable.

Install

/plugin marketplace add shalintripathi/organic-os
/plugin install organic-os@organic-os

Works the same on Claude Code CLI and Claude Cowork. Nothing to host: no server, no database, no MCP process.

Prerequisite: Python 3.9+ with PyYAML. Check with python3 -c "import yaml"; if that fails, run python3 -m pip install --user pyyaml before setup.

Run the setup interview

/organic-os:setup

An interview, not a form: site URL, brand voice, keywords, competitors, connectors, an optional WordPress connection, approval channel, and routine runtime. Every answer has a default and stays editable in site-profile.yaml: config is editable, memory is not. Setup scaffolds a private brain repo you own; nothing is sent anywhere else.

Pick your starting point

Zero credentials: audit any site

Answer the interview in analysis-only mode, then run /organic-os:onsite-audit https://yoursite.com. It reads the live page with no login and writes an on-page SEO report into the brain repo. Analysis is always free; only mutation is gated.

WordPress owner: gated writes to your own site

Create an Editor user with an Application Password (see the credentials guide), run setup with that connection, then /organic-os:onsite-audit, /organic-os:propose, approve what you want, and /organic-os:apply. Every write is verified against the live page after it lands.

Analytics operator: no WordPress needed

Connect GSC and GA4 at setup and skip WordPress. Run /organic-os:daily and /organic-os:weekly, manually at first, scheduled once you trust what they surface.

Going deeper

The full documentation lives in the repo, where it is versioned with the code: getting started, approval channels, routines and runtimes, and the site-repo contract. To remove everything, /organic-os:reset walks through each piece and never deletes your brain repo or revokes a credential on your behalf.