repowiseInstall repowise
Install the repowise CLI on macOS, Linux, or Windows via pip or uv. Verify, upgrade, switch versions, or uninstall — every step.
The repowise CLI is a Python package. You can install it with pip,
or — recommended — with uv, which puts
the binary into an isolated environment without touching your system
Python.
Before installing, make sure you've got Python 3.11+ and Git 2.30+.
Install
uv tool install repowiseuv tool install puts the binary in an isolated, uv-managed venv on
PATH. No conflicts with system Python, no requirements.txt to
maintain, fastest install path.
If you don't have uv yet:
# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows (PowerShell)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"pip install repowiseInstalls into your active Python environment. Fine for project-scoped installs (in a venv); not ideal for a global system install — there's no isolation from your other Python tools.
If you see a Defaulting to user installation message, the binary may
land in ~/.local/bin (Linux/macOS) or
%APPDATA%\Python\Scripts (Windows). Add that to PATH.
pipx install repowiseLike uv tool install — isolates the binary in its own venv. Use this
if you already standardise on pipx for CLI tools.
Verify
repowise --versionYou should see something like repowise 0.6.0. If command not found,
your PATH is missing the install location — see
Troubleshooting → command not found.
Optional provider extras
Repowise's default install supports any LLM provider via the OpenAI- and Anthropic-compatible HTTP APIs. If you want a provider-specific SDK installed (faster on large indexing runs), add an extra:
uv tool install 'repowise[anthropic]'
uv tool install 'repowise[openai]'
uv tool install 'repowise[gemini]'
uv tool install 'repowise[litellm]'pip install 'repowise[anthropic]'
pip install 'repowise[openai]'
pip install 'repowise[gemini]'
pip install 'repowise[litellm]'You'll know you need an extra when repowise init errors with
"Provider X requires the Y package".
Upgrade
uv tool upgrade repowisepip install --upgrade repowisepipx upgrade repowiseRun repowise --version again to confirm. Existing .repowise/
indexes are forward-compatible across minor versions; on a major
version bump, run repowise doctor --repair to migrate the store.
Pin to a specific version
uv tool install repowise==0.6.0
# or
pip install repowise==0.6.0The full release history is on PyPI.
Uninstall
uv tool uninstall repowisepip uninstall repowisepipx uninstall repowiseThe CLI is gone, but your .repowise/ directories are untouched —
delete them by hand if you want to reclaim the disk space:
# inside each indexed repo
rm -rf .repowise/Editable install (for contributors)
Hacking on repowise itself? Clone the OSS repo and install with uv
in editable mode:
git clone https://github.com/repowise-dev/repowise
cd repowise
uv sync --all-packages
uv run repowise --versionOr activate the venv uv sync created:
source .venv/bin/activate
repowise --helpSee CONTRIBUTING.md in the OSS repo for the full developer setup, including how to add a language and how to add a new LLM provider.
What's next
Set an API key — repowise calls an LLM to generate the wiki. Environment variables lists every key and provider option.
Index your first repo — head to the
Quickstart and run repowise init.
The first index of a 3,000-file project takes ~25 minutes; after that,
incremental updates run in under 30 seconds.
Connect Claude Code — repowise init already wrote .mcp.json
and registered the server. Restart Claude Code and you're done.
Don't want to install Python at all? The hosted version at repowise.dev runs the same engine on managed infrastructure — sign in with GitHub, paste a repo URL, you're done. Same MCP tools, same dashboard, no install.