Skip to content
heibenchPublic

About

CLI to pull MediaWiki pages as local wikitext files, edit them with your own tools, diff, and push the changes back under your account.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

wikisync

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/

Install

Download a binary for Linux, macOS or Windows from the releases, or build with Go 1.23+:

go install github.com/heibench/wikisync@latest

Quick start

# 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.

Status

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.

Docs

Contributing · Security · Apache-2.0 — see LICENSE.

About

CLI to pull MediaWiki pages as local wikitext files, edit them with your own tools, diff, and push the changes back under your account.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages