git-multiverse

Clone-free launcher for Multiverse.

Install

npm install -g git-multiverse

Commands

git-multiverse setup
git-multiverse start
git-multiverse stop
git-multiverse status
git-multiverse doctor
git-multiverse uninstall

State files

• ~/.git-multiverse/ (mode 0700)
• ~/.git-multiverse/.env (mode 0600)
• ~/.git-multiverse/docker-compose.yaml

Setup flow

git-multiverse setup writes local runtime files and starts Docker Compose automatically:

• anhdt5/git-multiverse:<tag>
• neo4j:5.26-community when using Docker with local database mode

Setup choices:

• runtime: docker or native
• db-mode: local or remote
• Docker mode can use either local Neo4j in Compose or a remote Neo4j database
• Native + remote-database startup runs the pre-built multiverse-api binary (pre-bundled for Linux and Windows) and connects directly to a remote Neo4j database without Docker.

Security defaults:

• host ports bind to 127.0.0.1
• MULTIVERSE_MCP_ALLOW_ANONYMOUS=false
• random admin and Neo4j passwords by default
• remote database URI, user, password, and database are required when using remote database mode
• secrets stay only in ~/.git-multiverse/.env

Non-interactive example

git-multiverse setup \
  --non-interactive \
  --runtime docker \
  --db-mode local \
  --workspace /workspace/repos \
  --image-tag latest

Docker with remote database example:

git-multiverse setup \
  --non-interactive \
  --runtime docker \
  --db-mode remote \
  --workspace /workspace/repos \
  --neo4j-uri neo4j+s://db.example.com:7687 \
  --neo4j-user neo4j \
  --neo4j-password 'replace-me' \
  --neo4j-database neo4j