Pull pages from any MediaWiki wiki into local .wiki files, edit them with the
tools you already use (an editor, grep, scripts, an LLM, offline), review the
diff, then push the changes back under your own account. Like git, for a wiki.
Documentation: https://heibench.com/wikisync/
Download a binary for Linux, macOS or Windows from the releases, or build with Go 1.23+:
go install github.com/heibench/wikisync@latest# The first pull names the wiki; the folder remembers it from then on
wikisync pull --host wiki.example.org --dir ./pages "Main Page"
wikisync pull --dir ./pages --category "Recipes"
# Edit the .wiki files, then see what changed (offline)
wikisync status --dir ./pages
wikisync diff --dir ./pages
# Preview the push (publishes nothing), then publish with a bot password
wikisync push --dir ./pages
export WIKISYNC_USERNAME_EXAMPLE='You@wikisync' WIKISYNC_PASSWORD_EXAMPLE='…'
wikisync push --dir ./pages --apply --summary "Fix typos" "Main Page"push previews by default, refuses pages someone else has edited since you
pulled them, never creates or deletes pages, and logs in with a scoped
MediaWiki bot password, never your account password.
The push --apply round trip and pull --watchlist run against a real
MediaWiki 1.45 in CI on every change, and all four commands have been used against
Appropedia. wikisync is 0.x: the command line may
still change between minor versions; see the changelog.
- Getting started
- Commands: every flag, output and exit code
- Credentials: setting up a bot password
- Working tree: file layout,
.wikisync/, conflicts - Development: building, testing, releasing
Contributing · Security · Apache-2.0 — see LICENSE.