# TechDex WP Toolkit Python Command List

This page lists the terminal commands exposed by TechDex WP Toolkit for AI(TM).

The commands below use the Python module form:

```powershell
python -m techdex_wp_toolkit --profile default COMMAND
```

If the console script is installed, the same command can usually be run as:

```powershell
techdex-wp-toolkit --profile default COMMAND
```

Use `--help` after any command to see its supported options:

```powershell
python -m techdex_wp_toolkit --profile default plugins redirection --help
```

## Global Options

These options go before the command:

```powershell
python -m techdex_wp_toolkit --profile default COMMAND
python -m techdex_wp_toolkit --env-file .\.env COMMAND
python -m techdex_wp_toolkit --profiles-file .\techdex_wp_toolkit_sites.json --profile default COMMAND
python -m techdex_wp_toolkit --projects-file .\techdex_wp_toolkit_projects.json --profile default COMMAND
python -m techdex_wp_toolkit --project-root C:\path\to\project --profile default COMMAND
python -m techdex_wp_toolkit --license-file .\.techdex_wp_toolkit\license.json --profile default COMMAND
```

## Standard Licensed Edition

These commands are available in the standard licensed edition.

### Site, Context, And License

```powershell
python -m techdex_wp_toolkit --profile default check
python -m techdex_wp_toolkit --profile default context
python -m techdex_wp_toolkit --profile default inspect
python -m techdex_wp_toolkit --profile default license status
python -m techdex_wp_toolkit --profile default license activate
python -m techdex_wp_toolkit --profile default license validate
python -m techdex_wp_toolkit --profile default license deactivate
```

### Categories, Tags, And Menus

```powershell
python -m techdex_wp_toolkit --profile default categories
python -m techdex_wp_toolkit --profile default tags
python -m techdex_wp_toolkit --profile default menus
python -m techdex_wp_toolkit --profile default create-tag
python -m techdex_wp_toolkit --profile default update-tag
python -m techdex_wp_toolkit --profile default create-category
python -m techdex_wp_toolkit --profile default update-category
```

### Navigation

```powershell
python -m techdex_wp_toolkit --profile default navigation-item
python -m techdex_wp_toolkit --profile default update-navigation-item
```

### Appearance, Widgets, And Sidebars

```powershell
python -m techdex_wp_toolkit --profile default appearance widgets
python -m techdex_wp_toolkit --profile default appearance sidebars
python -m techdex_wp_toolkit --profile default appearance widget
python -m techdex_wp_toolkit --profile default appearance create-widget
python -m techdex_wp_toolkit --profile default appearance update-widget
python -m techdex_wp_toolkit --profile default appearance delete-widget
python -m techdex_wp_toolkit --profile default appearance sidebar
python -m techdex_wp_toolkit --profile default appearance update-sidebar
```

### Comments

```powershell
python -m techdex_wp_toolkit --profile default comments
python -m techdex_wp_toolkit --profile default comment
python -m techdex_wp_toolkit --profile default update-comment
python -m techdex_wp_toolkit --profile default approve-comment
python -m techdex_wp_toolkit --profile default hold-comment
python -m techdex_wp_toolkit --profile default spam-comment
python -m techdex_wp_toolkit --profile default trash-comment
python -m techdex_wp_toolkit --profile default delete-comment
python -m techdex_wp_toolkit --profile default check-comment-urls
python -m techdex_wp_toolkit --profile default audit-comments
```

### Pages

```powershell
python -m techdex_wp_toolkit --profile default pages
python -m techdex_wp_toolkit --profile default page
python -m techdex_wp_toolkit --profile default create-page
python -m techdex_wp_toolkit --profile default update-page
python -m techdex_wp_toolkit --profile default unpublish-page
python -m techdex_wp_toolkit --profile default trash-page
python -m techdex_wp_toolkit --profile default delete-page
```

### Posts

```powershell
python -m techdex_wp_toolkit --profile default posts
python -m techdex_wp_toolkit --profile default post
python -m techdex_wp_toolkit --profile default create
python -m techdex_wp_toolkit --profile default create-from-json
python -m techdex_wp_toolkit --profile default update
python -m techdex_wp_toolkit --profile default unpublish-post
python -m techdex_wp_toolkit --profile default trash-post
python -m techdex_wp_toolkit --profile default delete-post
```

### Shared Post/Page Trash And Delete Commands

```powershell
python -m techdex_wp_toolkit --profile default trash
python -m techdex_wp_toolkit --profile default delete
```

### Media

```powershell
python -m techdex_wp_toolkit --profile default media
python -m techdex_wp_toolkit --profile default media-item
python -m techdex_wp_toolkit --profile default upload-media
python -m techdex_wp_toolkit --profile default update-media
```

### WooCommerce

```powershell
python -m techdex_wp_toolkit --profile default plugins woocommerce summary
python -m techdex_wp_toolkit --profile default plugins woocommerce products
python -m techdex_wp_toolkit --profile default plugins woocommerce product
python -m techdex_wp_toolkit --profile default plugins woocommerce create-product
python -m techdex_wp_toolkit --profile default plugins woocommerce update-product
python -m techdex_wp_toolkit --profile default plugins woocommerce configure-variable-pricing
```

### Redirection

```powershell
python -m techdex_wp_toolkit --profile default plugins redirection summary
python -m techdex_wp_toolkit --profile default plugins redirection status
python -m techdex_wp_toolkit --profile default plugins redirection settings
python -m techdex_wp_toolkit --profile default plugins redirection redirects
python -m techdex_wp_toolkit --profile default plugins redirection logs
python -m techdex_wp_toolkit --profile default plugins redirection 404s
python -m techdex_wp_toolkit --profile default plugins redirection audit-404s
python -m techdex_wp_toolkit --profile default plugins redirection groups
python -m techdex_wp_toolkit --profile default plugins redirection trace-url
python -m techdex_wp_toolkit --profile default plugins redirection create-redirect
python -m techdex_wp_toolkit --profile default plugins redirection redirect
python -m techdex_wp_toolkit --profile default plugins redirection update-redirect
python -m techdex_wp_toolkit --profile default plugins redirection enable-redirect
python -m techdex_wp_toolkit --profile default plugins redirection disable-redirect
python -m techdex_wp_toolkit --profile default plugins redirection reset-redirect
python -m techdex_wp_toolkit --profile default plugins redirection delete-redirect
```

## License Free Edition Additions

The License Free edition includes every standard command above, plus the commands below.

Some of these commands require the included TechDex Toolkit Companion plugin to be installed on the target WordPress site.

### Settings

```powershell
python -m techdex_wp_toolkit --profile default settings
python -m techdex_wp_toolkit --profile default update-settings
```

### Additional CSS

```powershell
python -m techdex_wp_toolkit --profile default custom-css inspect
python -m techdex_wp_toolkit --profile default custom-css backup
python -m techdex_wp_toolkit --profile default custom-css diff
python -m techdex_wp_toolkit --profile default custom-css update
python -m techdex_wp_toolkit --profile default custom-css backups
python -m techdex_wp_toolkit --profile default custom-css restore
```

### Error Logs

```powershell
python -m techdex_wp_toolkit --profile default error-logs
```

### Comment Spam Control

```powershell
python -m techdex_wp_toolkit --profile default comment-spam inspect
python -m techdex_wp_toolkit --profile default comment-spam templates
python -m techdex_wp_toolkit --profile default comment-spam apply-template
```

### Writing Ping List

```powershell
python -m techdex_wp_toolkit --profile default writing-pings inspect
python -m techdex_wp_toolkit --profile default writing-pings templates
python -m techdex_wp_toolkit --profile default writing-pings apply-template
```

### Users

```powershell
python -m techdex_wp_toolkit --profile default users
python -m techdex_wp_toolkit --profile default user
python -m techdex_wp_toolkit --profile default audit-users
python -m techdex_wp_toolkit --profile default update-user-password
python -m techdex_wp_toolkit --profile default remove-user-roles
```

### Wordfence

```powershell
python -m techdex_wp_toolkit --profile default plugins wordfence summary
python -m techdex_wp_toolkit --profile default plugins wordfence options
python -m techdex_wp_toolkit --profile default plugins wordfence audit
python -m techdex_wp_toolkit --profile default plugins wordfence templates
python -m techdex_wp_toolkit --profile default plugins wordfence apply-template
python -m techdex_wp_toolkit --profile default plugins wordfence set-options
python -m techdex_wp_toolkit --profile default plugins wordfence blocks
python -m techdex_wp_toolkit --profile default plugins wordfence create-ip-block
python -m techdex_wp_toolkit --profile default plugins wordfence delete-block
python -m techdex_wp_toolkit --profile default plugins wordfence make-block-permanent
python -m techdex_wp_toolkit --profile default plugins wordfence live-traffic
python -m techdex_wp_toolkit --profile default plugins wordfence events
```

## Common Option Examples

These examples show the kind of arguments some commands expect. Use `--help` for the complete option list for each command.

```powershell
python -m techdex_wp_toolkit --profile default post --post-id 123
python -m techdex_wp_toolkit --profile default page --page-id 123
python -m techdex_wp_toolkit --profile default media-item --media-id 123
python -m techdex_wp_toolkit --profile default comment --comment-id 123
python -m techdex_wp_toolkit --profile default appearance widget --widget-id block-4
python -m techdex_wp_toolkit --profile default plugins woocommerce product --product-id 123
python -m techdex_wp_toolkit --profile default plugins redirection redirect --redirect-id 123
python -m techdex_wp_toolkit --profile default plugins wordfence delete-block --block-id 123
```

Create or update from files:

```powershell
python -m techdex_wp_toolkit --profile default create --title "Example Post" --markdown-file .\post.md
python -m techdex_wp_toolkit --profile default update-page --page-id 123 --html-file .\page.html
python -m techdex_wp_toolkit --profile default upload-media --file .\image.jpg --title "Hero Image" --alt-text "Hero image"
python -m techdex_wp_toolkit --profile default custom-css diff --file .\custom.css
python -m techdex_wp_toolkit --profile default custom-css update --file .\custom.css
```

Preview-first template commands:

```powershell
python -m techdex_wp_toolkit --profile default comment-spam apply-template --name recommended
python -m techdex_wp_toolkit --profile default writing-pings apply-template --name recommended
python -m techdex_wp_toolkit --profile default plugins wordfence apply-template --name recommended
```

Apply template changes only when intended:

```powershell
python -m techdex_wp_toolkit --profile default comment-spam apply-template --name recommended --apply
python -m techdex_wp_toolkit --profile default writing-pings apply-template --name recommended --apply
python -m techdex_wp_toolkit --profile default plugins wordfence apply-template --name recommended --apply
```

## Safety Notes

- Run `inspect` before live-site changes.
- Fetch the exact object before updating it.
- Prefer drafts, previews, and trash workflows when available.
- Treat deletes, unpublishes, pricing changes, user changes, navigation changes, redirect changes, and Wordfence blocks as deliberate live-site changes.
- Use `--help` on unfamiliar commands before running them.