Configuration

Config File Location

~/.wp-seo-ops/config.json — JSON file created by seo-ops config init.

Default Config

{
  "version": "0.1.0",
  "default_path": "",
  "seo_plugin": "auto",
  "output_format": "table",
  "color": true,
  "ai": {
    "provider": "none",
    "model": ""
  },
  "indexing": {
    "indexnow_key": "",
    "key_location": "",
    "default_engine": "indexnow"
  },
  "gsc_credentials_path": "",
  "gsc_site_url": ""
}

Commands

seo-ops config init

Creates default config file. Safe to re-run — won't overwrite existing config.

seo-ops config init
# Created config: /home/user/.wp-seo-ops/config.json

seo-ops config get <key>

Read a config value. Nested keys use dot notation.

seo-ops config get default_path
# /var/www/html

seo-ops config get indexing.indexnow_key
# (value or empty)

seo-ops config set <key> <value>

Write a config value.

seo-ops config set default_path /var/www/html
seo-ops config set indexing.default_engine indexnow

Config Keys Reference

Key	Type	Default	Description
version	string	"0.1.0"	Config schema version
default_path	string	""	Default WordPress path used when --path is omitted
seo_plugin	string	"auto"	Force a specific SEO plugin or auto-detect
output_format	string	"table"	Default output format
color	boolean	true	Enable colored terminal output
ai.provider	string	"none"	AI provider for content generation
ai.model	string	""	AI model for content generation
indexing.indexnow_key	string	""	IndexNow API key
indexing.key_location	string	""	Path to IndexNow key file
indexing.default_engine	string	"indexnow"	Default indexing engine
gsc_credentials_path	string	""	Path to GSC service account JSON
gsc_site_url	string	""	Google Search Console site URL

Environment Variables

Variable	Description
WP_SEO_OPS_CONFIG	Override config file path
WP_SEO_OPS_DEBUG	Enable debug mode
WP_SEO_OPS_NO_COLOR	Disable terminal colors