# repowise-dev/repowise

> repowise is a command-line tool and MCP server that indexes a code repository and its git history so developers and coding agents can see what a change touches. It covers code health scores, generated docs, git analytics, dead code detection and architectural decisions. The index is built once on your machine, and agents query it through the Model Context Protocol instead of grepping and opening files. The project is written mainly in Python, with TypeScript in its UI and API client packages.

Source: https://github.com/repowise-dev/repowise
Indexed: commit ef827a2 on 2026-11-17 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: MCP server
- Language: Python
- Stars: 8,166 at index time
- License: AGPL-3.0
- Code health: 8.2/10, Good
- Last commit: 2026-11-17
- Contributors: 269

## Install

From the README: https://github.com/repowise-dev/repowise

Clone the repowise repository.
    git clone https://github.com/repowise-dev/repowise.git

Move into the repowise folder.
    cd repowise

Install repowise with uv.
    uv tool install repowise

Change into the repository you want to index.
    cd /path/to/your/repo

## How to use

Index the repository without an API key.
    repowise init --yes --no-prose

Start the dashboard and the MCP server. The first run downloads the UI.
    repowise serve

## How it works

The command line in packages/cli/src/repowise/cli/main.py is the entry point for commands such as init, serve, risk and dead-code. The packages/core directory is the engine that indexes the repository and answers questions about its code, and the CLI, the server routes and the MCP server all call into it. The MCP server in packages/server/src/repowise/server/mcp_server/tool_answer/answer.py is one of the files behind the answer tool that agents call. packages/core/src/repowise/core/analysis/health/engine.py computes the health score for each file, and packages/core/src/repowise/core/analysis/dead_code/analyzer.py finds unused code. Developers reach the same index through the terminal, a browser dashboard or an editor extension.

- examples/plugins/hello/src/repowise_hello/__init__.py: entry point
- packages/api-client/src/index.ts: entry point
- packages/cli/src/repowise/cli/augment_hook.py: entry point
- packages/cli/src/repowise/cli/main.py: entry point
- packages/cli/src/repowise/cli/rewrite_hook.py: entry point
Modules: packages, tests, scripts, ci, docker, docs, examples, root. 7,349 files, 1,261,093 lines, 95,052 symbols.

## Code health

- Score: 8.2/10 (Good)
- Trend: 8.2 on 2026-11-17, 8.2 on 2026-11-17, 8.2 on 2026-11-17
- Rank: #45 of 4,000+ indexed repos
- Hotspots: packages/cli/src/repowise/cli/commands/update_cmd/command.py, packages/core/src/repowise/core/ingestion/call_resolver.py, packages/core/src/repowise/core/analysis/dead_code/analyzer.py, packages/server/src/repowise/server/mcp_server/tool_answer/answer.py, packages/core/src/repowise/core/analysis/health/engine.py
- Lowest file: packages/core/src/repowise/core/ingestion/graph_warmups.py
- Dead code: none found

## Maintenance

- Last commit 2026-11-17, first commit 2026-03-23, 4,074 commits
- 269 contributors, bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/repowise-dev/repowise/security

## More

- Page: https://repowise.dev/repo/repowise-dev/repowise
- Ask this codebase: https://repowise.dev/repo/repowise-dev/repowise/chat
- Docs: https://repowise.dev/repo/repowise-dev/repowise/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/repowise-dev/repowise
