Home

Local-first WordPress tooling.

This wiki serves as the main source of truth for using, configuring, and extending localpress.

What is localPress?

localPress is a CLI tool that processes WordPress media on your local machine and syncs results back to a remote WordPress site via the REST API. No cloud SaaS, no recurring credits, no WordPress plugin required.

Quick Start

1. Install: brew install gfargo/localpress/localpress
2. Connect: localpress init --url https://your-site.com
3. Audit: localpress audit
4. Optimize: localpress optimize --unoptimized --apply

Core Concepts

• Local processing: Your laptop's CPU/GPU does the work
• WordPress integration: Works via Application Passwords (built into WP core)
• Idempotent operations: Safe to run repeatedly
• Always undoable: Every destructive op is snapshotted locally and reversible via localpress undo
• Vision AI built in: Local Ollama vision model generates alt text, titles, descriptions, tags, and content-type classification
• AI agent ready: First-party MCP server + companion markdown skill

Documentation Sections

• Getting Started - Installation and first steps
• Commands Reference - Complete CLI command documentation
• Configuration - Config files, profiles, and site management
• AI Agent Integration - Using localpress with Claude Desktop, Cursor, etc.
• MCP Setup - First-party Model Context Protocol server for agentic workflows
• History & Undo - Time-machine: every destructive op is snapshotted and reversible
• Advanced Usage - Bulk operations, automation, workflows
• Troubleshooting - Common issues and solutions
• Development - Contributing, building from source, architecture

Need Help?

• GitHub Issues: Report bugs or request features
• GitHub Discussions: Ask questions