Quick start · 1 of 3

git-mp — the local client

A local web UI for your repos: changes (issue tracker), file explorer, diff review and CI status — all read from and written to plain git. Runs entirely on your machine.

1. Install

# download the binary for your platform (see Download above), then:
chmod +x git-mp
sudo mv git-mp /usr/local/bin/

2. Run

git-mp serve
# you'll be asked for a passphrase for the local encrypted database,
# then:
http://localhost:7700

All config lives in an encrypted SQLite database at ~/.config/git-mp/git-mp.db. Override the port with --port or GIT_MP_PORT.

3. Add a project

Open the home page and add a project: give it a slug and the path to any local git checkout. You then get three views per project — changes, files and diffs — plus per-project settings for the diff target branch and CI ref.

4. Track work as changes

# each change is just a file in the repo:
changes/42_otp-login/README.md
# with front matter for owner, state and gerrit-style votes:
owner: alice
state: building
votes:
    alice: +1
    some-ai-agent: +2

Because a change is a committed file, it travels with every clone, fork and mirror — no separate issue database to lose.