![\"Pressship\"](\"assets/pressship-square-dark.png\")
\n \n \n
\n WordPress.org plugin publishing, from the terminal.\n
\n\n\n ![\"Node.js](\"https://img.shields.io/badge/node-%3E%3D20-1e293b?logo=node.js&logoColor=white&style=flat-square\"){kind=icon}
![\"npm\"](\"https://img.shields.io/npm/v/pressship?color=3858e9&logo=npm&logoColor=white&style=flat-square\")
![\"WordPress.org\"](\"https://img.shields.io/badge/WordPress.org-plugin%20directory-21759b?logo=wordpress&logoColor=white&style=flat-square\"){kind=icon}
![\"License:](\"https://img.shields.io/badge/license-MIT-3858e9?style=flat-square\"){kind=icon}
![\"GitHub](\"https://img.shields.io/github/stars/Automattic/pressship?style=flat-square&logo=github&color=1e293b\")
\n Quick start ·\n Commands ·\n Managed Plugin Check ·\n Agent skill ·\n Docs\n
\n\n---\n\nPressship is a modern command-line tool for the entire WordPress.org plugin publishing lifecycle — validating, packaging, submitting for review, releasing through SVN, inspecting submission state, and even booting your plugin in [WordPress Playground](https://wordpress.org/playground/).\n\nIt keeps WordPress.org-specific behavior **explicit** and makes everything around it **quiet**.\n\n```bash\nnpx pressship publish ./my-plugin\n```\n\n## Why Pressship?\n\nPublishing a WordPress plugin to WordPress.org normally means juggling a lot of small things: the right zip layout, `readme.txt` validation, Plugin Check setup, the developer-page upload form, then SVN for releases. Pressship automates the chores while keeping the official WordPress.org review and SVN release behavior intact.\n\nIf you've used `npm publish`, this should feel familiar.\n\n## Quick start\n\n```bash\n# 1. Authenticate with WordPress.org\nnpx pressship login\n\n# 2. (Optional) Verify the saved session\nnpx pressship whoami\n\n# 3. Verify the plugin without packaging or uploading\nnpx pressship verify ./my-plugin\n\n# 4. Submit for review or release an approved plugin\nnpx pressship publish ./my-plugin\n```\n\nThat's it. Pressship handles browser-based login, packaging, readme validation, Plugin Check, and routing between submission and SVN release.\n\n## Features\n\n- **Browser-based login** — opens `login.wordpress.org` in a real browser and saves only the session locally. Your password is never read or stored.\n- **Smart `publish`** — automatically routes between new-plugin review submission, pending reupload, or SVN release.\n- **Zero-setup Plugin Check** — bundles its own managed WordPress + SQLite + Plugin Check environment when you don't already have WP-CLI.\n- **WordPress.org readme validator** — runs the official validator before you upload anything.\n- **Submission state inspector** — reads the logged-in developer page to surface review status, slug, reupload availability, and Plugin Check links.\n- **SVN release workflow** — handles checkout, trunk sync, tag creation, and commit.\n- **WordPress Playground demos** — boot any local path or hosted slug in Playground using the plugin's own WP/PHP requirements.\n- **Pressship Studio** — a local VS Code-style workspace with file tabs, Playground previews, AI assistance, release management, package-size checks, and CLI command hints in the terminal.\n- **`.pressshipignore` + glob ignores** — sensible defaults, easy per-command overrides.\n- **Agent skill included** — a Pressship publishing skill for coding agents (Codex, Claude Code, etc.).\n- **Beautiful terminal UX** — colored output, progress indicators, structured findings.\n\n## Requirements\n\n- **Node.js 20+**\n- A **WordPress.org account**\n- **Internet access** for first-run browser and Plugin Check setup\n- **PHP** when Pressship needs to prepare its managed Plugin Check environment\n- **`svn`** for approved-plugin releases and `get` checkouts. If it is missing, Pressship can detect your OS and offer to install Subversion with Homebrew, apt, dnf, yum, pacman, zypper, apk, winget, or Chocolatey.\n\nPlaywright Chromium is installed automatically the first time browser automation runs.\n\n## Commands\n\n| Command | What it does |\n| ------- | ------------ |\n| `pressship login` | Open WordPress.org login in a browser and save the session. |\n| `pressship whoami` | Show the active WordPress.org account. |\n| `pressship logout` | Remove the saved WordPress.org session. |\n| `pressship info` | Inspect local plugin metadata or hosted WordPress.org plugin info. |\n| `pressship ls` | List plugins for the saved account or a public WordPress.org profile. |\n| `pressship get` | Checkout or update a WordPress.org plugin SVN working copy. |\n| `pressship studio` | Start Pressship Studio for plugin operations, editing, and Playground previews. |\n| `pressship status` | Read review state from the logged-in developer dashboard. |\n| `pressship version