Admin Dashboard

Accessing the dashboard

After installing PromptWire, the admin dashboard is available at Setup > PromptWire Admin in the ProcessWire admin. It requires the promptwire-admin permission.

The page tree

The dashboard shows your full page tree with sync status for each page. The default view shows the home page and its direct children, matching ProcessWire's native sort order. Click the chevron next to any page to expand its children (loaded via AJAX).

Each row displays:

Column	Description
Checkbox	Select pages for bulk operations. The header checkbox selects all visible pages.
Title	Page title with tree indentation. Links to the ProcessWire page editor. Unpublished pages appear with strikethrough styling; hidden pages are faded.
Template	The template machine name.
Sync status	A colour-coded badge showing the page's sync state.
Modified	When the page was last modified, shown as relative time.
Actions	Per-page action icons (see below).

Sync status badges

Each page shows one of these status badges:

Badge	Meaning
Clean	The local file matches the database. No action needed.
File Newer	The local YAML file has been modified since the last pull or push. You can apply these changes with "File to Wire".
Wire Newer	The page was modified in ProcessWire since the last pull. You may want to re-pull to update your local file.
Conflict	Both the local file and the database have changed. Review both sets of changes before deciding which to keep.
Untracked	This page has never been pulled. No local file exists for it.

Per-page actions

Three action icons appear on each row:

Wire to File

Pulls the page from ProcessWire into a local YAML file, creating or updating the sync directory for that page. Available on all pages.

Files are exported to site/assets/pw-mcp/, mirroring the page's URL path. A page at /about/team/ becomes site/assets/pw-mcp/about/team/page.yaml. Rich text fields are saved as separate HTML files in a fields/ subdirectory (e.g. fields/body.html). See Content Sync for the full directory structure.

File to Wire

Pushes local file changes back to ProcessWire. Only available for pages that have been pulled (not "Untracked"). The file is read from the same site/assets/pw-mcp/ directory.

Clicking this opens a preview showing all field-level changes as a diff. You can:

• Exclude individual fields from the push by toggling them off in the preview.
• Refresh a field to reload its current value from disk.
• Apply to write the changes to ProcessWire.

If a conflict is detected, you'll see both remote and local change sets. You can re-export (pull the latest from PW) or force apply (overwrite PW with your local version).

View YAML

Opens a read-only view of the page's page.yaml file. Only available for pages that have been pulled.

Bulk operations

Select multiple pages using the checkboxes, then use the toolbar buttons:

• Wire to File: pull all selected pages to local files.
• File to Wire: push local changes for all selected pages. Only enabled when at least one selected page has local modifications. A confirmation dialog appears before applying.

The toolbar shows a selection summary: how many pages are selected and how many of those have local modifications.

Filters

Three filter controls appear above the page tree:

• Search: filter by page title or name (debounced, minimum 2 characters).
• Template: show only pages using a specific template. Each template shows a count of matching pages.
• Status: show only pages with a specific sync status (Clean, File Newer, Wire Newer, Conflict, Untracked). Each status shows a count.

When filters are active, the tree view flattens to a list of matching pages. Click "Clear filters" to return to the tree view.

Reconcile

The Reconcile button (in the page header) runs a dry-run reconciliation scan that detects path drift (pages moved in ProcessWire while local files still reference the old path), orphans (pages deleted in ProcessWire), and new scaffolds (pages created locally but not yet published). You can then confirm to apply the fixes.

Expand All

The "Expand All" toggle recursively expands every page in the tree so you can see the full sync status of your entire site at a glance.