How repowise-dev/repowise works
Repowise builds a local codebase index and exposes it to coding agents and people through MCP, a dashboard, and editor integrations. The principal workflow is to initialize a repository, analyze code and history, then query the resulting index for architecture, change impact, tests, and improvement priorities. README capabilities also include generated documentation, command-output distillation, hooks, cross-repository system maps, and savings reporting. Several links below are supported by README claims; sampled source confirms only selected implementation details, so unsampled internals are not inferred.
Main entry points: app.py Local server · main.py CLI commands · client.ts API client · serverManager.ts VS Code host
Components 18
Index and analysis
- CLI commands
packages/cli/src/repowise/cli/main.py - Repository setup
packages/cli/src/repowise/cli/commands/init_cmd/command.py - Code ingestion
packages/core/src/repowise/core/ingestion/framework_routes.py - Wiki generation
packages/cli/src/repowise/cli/commands/generate_cmd/engine.py - Fix-first ranking
packages/core/src/repowise/core/analysis/actions/engine.py - Test coverage
packages/server/src/repowise/server/routers/code_health/coverage_routes.py
Agent experience
- MCP tools
packages/server/src/repowise/server/mcp_server - Output distillation
packages/core/src/repowise/core/distill/engine.py - Agent hooks
packages/cli/src/repowise/cli/augment_hook.py - Claude map view
packages/claude-mod/src/map-controller.ts
Serving and clients
- Local server
packages/server/src/repowise/server/app.py - API client
packages/api-client/src/client.ts
User interfaces
- Web dashboard
packages/ui/src/workspace/system-map/system-map-routes-panel.tsx - Cross-repo map
packages/ui/src/workspace/system-map/routes-between.ts - VS Code host
packages/vscode/src/features/serverManager.ts - VS Code panels
packages/vscode/webview/src/runtime/mount.tsx - Webview RPC
packages/vscode/webview/src/runtime/rpc.ts
Other components
- Developer
Connections 20
- Developer → CLI commands: runs commands
README.md - CLI commands → Repository setup: sets up index
README.md - Repository setup → Code ingestion: indexes repository
README.md - CLI commands → Wiki generation: generates docs
README.md - Developer → Local server: opens dashboard
README.md - Local server → MCP tools: offers MCP
README.md - Developer → MCP tools: asks questions
README.md - MCP tools → API client: queries index
- Local server → API client: serves data
packages/server/src/repowise/server/app.py - API client → Web dashboard: feeds views
- Code ingestion → Fix-first ranking: analyzes code
- Local server → Test coverage: routes coverage
packages/server/src/repowise/server/routers/code_health/coverage_routes.py - CLI commands → Output distillation: distills output
README.md - CLI commands → Agent hooks: installs hooks
README.md - Developer → Claude map view: explores map
README.md - Local server → Cross-repo map: serves service links
- VS Code host → Local server: connects locally
- VS Code panels → Webview RPC: creates host
packages/vscode/webview/src/runtime/mount.tsx - Webview RPC → VS Code host: sends requests
packages/vscode/webview/src/runtime/rpc.ts - VS Code host → API client: uses client
packages/vscode/src/features/serverManager.ts