Skip to content

Codebase intelligence for AI and humans: code health scores, auto-generated docs, git analytics, dead code detection, and architectural decisions via MCP.

chore(uv): document uv workflow and migrate to dependency-groups (#100)

Raghav Chamadiya36bd059db947
diff --git a/README.md b/README.md
index fa334ea5e..c7fa3cd4c 100644
--- a/README.md
+++ b/README.md
@@ -92,6 +92,12 @@ These become structured decision records, queryable by Claude Code via `get_why(
pip install repowise
```
+Or install the CLI into an isolated, uv-managed environment:
+
+```bash
+uv tool install repowise
+```
+
### Single repo
```bash
@@ -594,8 +600,22 @@ Full configuration reference: [docs/CONFIG.md](docs/CONFIG.md)
```bash
git clone https://github.com/repowise-dev/repowise
cd repowise
-pip install -e "packages/core[dev]"
-pytest tests/unit/
+uv sync --all-packages
+uv run repowise --version
+uv run pytest tests/unit/
+```
+
+Run commands through uv without activating the environment:
+
+```bash
+uv run repowise --help
+```
+
+Or activate the local environment created by `uv sync`:
+
+```bash
+source .venv/bin/activate
+repowise --help
```
Full guide including how to add languages and LLM providers: [CONTRIBUTING.md](CONTRIBUTING.md)
diff --git a/docs/USER_GUIDE.md b/docs/USER_GUIDE.md
index a81654ee3..5a114f7a7 100644
--- a/docs/USER_GUIDE.md
+++ b/docs/USER_GUIDE.md
@@ -71,6 +71,17 @@ repowise --version
repowise --help
```
+### From Source with uv
+
+For local development, use the workspace lockfile from the repository root:
+
+```bash
+git clone https://github.com/repowise-dev/repowise.git
+cd repowise
+uv sync --all-packages
+uv run repowise --version
+```
+
---
## Getting Started
diff --git a/pyproject.toml b/pyproject.toml
index 25e6b6c7f..e79811038 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -169,8 +169,8 @@ members = [
"packages/server",
]
-[tool.uv]
-dev-dependencies = [
+[dependency-groups]
+dev = [
"pytest>=8,<9",
"pytest-asyncio>=0.23,<1",
"pytest-snapshot>=0.9,<1",