### Docker Quickstart

Source: https://github.com/repowise-dev/repowise/blob/main/website/self-hosting.md

Run the Repowise Docker image for a quick setup. This command pulls the latest image, maps ports, mounts volumes for the repository and data, sets an environment variable for Anthropic API key, and starts the serve command.

```bash
docker pull ghcr.io/repowise-dev/repowise:latest

docker run \
  -p 7337:7337 \
  -p 3000:3000 \
  -v $(pwd):/repo \
  -v $(pwd)/.repowise:/data \
  -e ANTHROPIC_API_KEY="sk-ant-..." \
  ghcr.io/repowise-dev/repowise:latest \
  serve /repo
```

--------------------------------

### Initialize Repowise Plugin

Source: https://github.com/repowise-dev/repowise/blob/main/plugins/claude-code/README.md

Run this command after installing the plugin to start the setup and indexing process.

```shell
/repowise:init
```

--------------------------------

### Install and Initialize OpenCode CLI

Source: https://github.com/repowise-dev/repowise/blob/main/website/opencode.md

Install the OpenCode CLI using curl and then run the initial setup command. This prepares OpenCode for use.

```bash
curl -fsSL https://opencode.ai/install | bash
opencode                      # first-run setup: configure your provider

cd /path/to/your-repo
repowise init --provider opencode --yes
```

--------------------------------

### OpenCode CLI Installation and Setup Instructions

Source: https://github.com/repowise-dev/repowise/blob/main/website/opencode.md

Instructions for installing OpenCode via curl and performing the first-run setup. This is displayed when OpenCode is not detected during interactive setup.

```bash
Install:   curl -fsSL https://opencode.ai/install | bash
Setup:     opencode  (first run sets up your provider)
Models:    opencode models  (list available models)
```

--------------------------------

### Development Setup Commands

Source: https://github.com/repowise-dev/repowise/blob/main/website/contributing.md

Clone the repository and install dependencies for both the Python backend and the web frontend. Run tests and linting checks.

```bash
git clone https://github.com/repowise-dev/repowise.git
cd repowise
uv sync --all-extras     # Python dependencies
npm install              # Web frontend
npm run build            # Build frontend
pytest                   # Run tests
ruff check packages/     # Lint
```

--------------------------------

### First-time setup for a single repo

Source: https://github.com/repowise-dev/repowise/blob/main/docs/USER_GUIDE.md

Installs Repowise with Anthropic support, sets the API key, and initializes the tool for a single repository. Installs a git hook for automatic syncing after commits.

```bash
pip install "repowise[anthropic]"
export ANTHROPIC_API_KEY="sk-ant-..."
cd /path/to/your-project
repowise init
repowise hook install    # auto-sync after every commit
```

--------------------------------

### Start API Server and Web UI

Source: https://github.com/repowise-dev/repowise/blob/main/docs/USER_GUIDE.md

Starts the API server and web UI. If Node.js 20+ is installed, the web frontend is automatically downloaded and started. Use --no-ui to start the API server only.

```bash
repowise serve [PATH]
```

```bash
# Start everything (API + Web UI)
repowise serve
```

```bash
# API only
repowise serve --no-ui
```

```bash
# Custom ports
repowise serve --port 8080 --ui-port 8081
```

--------------------------------

### Build and Run Repowise from Source

Source: https://github.com/repowise-dev/repowise/blob/main/website/self-hosting.md

Clone the repository, install Python dependencies, build the web frontend, and start the Repowise server.

```bash
git clone https://github.com/repowise-dev/repowise.git
cd repowise

# Python dependencies
uv sync --all-extras

# Web frontend
npm install
npm run build

# Run
repowise serve
```

--------------------------------

### Initialize Repowise Project

Source: https://github.com/repowise-dev/repowise/blob/main/docs/QUICKSTART.md

Navigate to your repository and run 'repowise init' to start the interactive setup. This process parses files, builds dependency graphs, indexes git history, and generates wiki pages.

```bash
cd /path/to/your-repo
repowise init
```

--------------------------------

### Install and Initialize Repowise with OpenCode CLI

Source: https://github.com/repowise-dev/repowise/blob/main/website/configuration.md

Install the OpenCode CLI using curl, run the first-run setup, and then initialize Repowise using the 'opencode' provider. Repowise automatically detects OpenCode when it's on the PATH.

```bash
curl -fsSL https://opencode.ai/install | bash
opencode       # first-run setup
repowise init --provider opencode --yes
```

--------------------------------

### First-time setup for a multi-repo workspace

Source: https://github.com/repowise-dev/repowise/blob/main/docs/USER_GUIDE.md

Installs Repowise with Anthropic support, sets the API key, and initializes the tool for a multi-repository workspace. Installs a git hook for automatic syncing across the workspace.

```bash
pip install "repowise[anthropic]"
export ANTHROPIC_API_KEY="sk-ant-..."
cd /path/to/workspace/   # parent dir with backend/, frontend/, etc.
repowise init .
repowise hook install --workspace
```

--------------------------------

### Quick Start: Generate and Manage Docs

Source: https://github.com/repowise-dev/repowise/blob/main/packages/cli/README.md

Initialize documentation, check its status, update it after commits, search the wiki, and start the web UI.

```bash
# 1. Generate documentation for the first time
cd /path/to/your/repo
repowise init --provider anthropic
```

```bash
# 2. Check what was generated
repowise status
```

```bash
# 3. Keep docs in sync after commits
repowise update
```

```bash
# 4. Search the wiki
repowise search "authentication flow"
```

```bash
# 5. Start the web UI
repowise serve
```

--------------------------------

### Install Repowise Core (Basic)

Source: https://github.com/repowise-dev/repowise/blob/main/packages/core/README.md

Install the core library with basic functionality, using the SQLite backend and no vector search.

```bash
pip install repowise-core
```

--------------------------------

### Install Repowise

Source: https://github.com/repowise-dev/repowise/blob/main/README.md

Install the Repowise package using pip or uv. This is the first step for any user.

```bash
pip install repowise          # or: uv tool install repowise
```

--------------------------------

### Start Repowise API Server and Web UI

Source: https://github.com/repowise-dev/repowise/blob/main/docs/CLI_REFERENCE.md

Starts the API server and web UI. Use `--no-ui` to start the API server only. Customize ports with `--port` and `--ui-port`. Use `--refresh-ui` to bypass cache and force a fresh download of the web UI.

```bash
repowise serve                           # API + Web UI
```

```bash
repowise serve --no-ui                   # API only
```

```bash
repowise serve --port 8080 --ui-port 8081
```

```bash
repowise serve --refresh-ui              # bypass cache, pull latest UI tarball
```

--------------------------------

### Install Repowise for Development

Source: https://github.com/repowise-dev/repowise/blob/main/packages/server/README.md

Installs the server and core packages in editable mode for development. Ensure you are in the repository root.

```bash
uv pip install -e packages/server -e packages/core
```

--------------------------------

### Install repowise-cli

Source: https://github.com/repowise-dev/repowise/blob/main/packages/cli/README.md

Install the repowise-cli package using pip or uv. repowise-core is installed as a dependency.

```bash
pip install repowise-cli
```

```bash
uv pip install repowise-cli
```

--------------------------------

### Start Repowise Web UI

Source: https://github.com/repowise-dev/repowise/blob/main/docs/WORKSPACES.md

Start the Repowise web-based user interface for exploring your indexed repositories.

```bash
repowise serve
```

--------------------------------

### Install Repowise for Development

Source: https://github.com/repowise-dev/repowise/blob/main/packages/core/README.md

Use this command to install the core package with search extras for development purposes. Ensure you are in the repository root.

```bash
# Install for development (from repo root)
uv pip install -e "packages/core[search]"
```

--------------------------------

### Install Repowise and Codex CLI

Source: https://github.com/repowise-dev/repowise/blob/main/docs/QUICKSTART.md

Install Repowise and the Codex CLI for subscription flow. No provider SDK or API key is required for this method.

```bash
pip install repowise
npm install -g @openai/codex
codex login
```

--------------------------------

### Install Repowise using Pip

Source: https://github.com/repowise-dev/repowise/blob/main/plugins/claude-code/commands/init.md

Use this command to install Repowise. The `[all]` option includes all LLM provider dependencies.

```bash
pip install repowise
```

```bash
pip install "repowise[all]"
```

--------------------------------

### Install Repowise Core Engine

Source: https://github.com/repowise-dev/repowise/blob/main/docs/USER_GUIDE.md

Installs the main repowise engine, CLI, server, and MCP tools. LLM provider SDKs are not included by default.

```bash
pip install repowise
```

--------------------------------

### Install LiteLLM and Initialize Repowise

Source: https://github.com/repowise-dev/repowise/blob/main/docs/CONFIG.md

Install the Repowise package with LiteLLM support, set the LITELLM_API_KEY, and initialize Repowise using LiteLLM to access various providers.

```bash
pip install "repowise[litellm]"
export LITELLM_API_KEY="..."
repowise init --provider litellm --model azure/gpt-4
```

--------------------------------

### Get Overview Tool Call

Source: https://github.com/repowise-dev/repowise/blob/main/docs/MCP_TOOLS.md

This is an example of how to call the get_overview tool. This tool is used to get a summary of a codebase, including its architecture, modules, entry points, and community summary. It is recommended as the first call on any unfamiliar codebase.

```plaintext
get_overview()
```

--------------------------------

### Initialize Documentation (repowise init)

Source: https://github.com/repowise-dev/repowise/blob/main/packages/cli/README.md

Generate full wiki documentation from scratch. This is a one-time operation that traverses files, builds dependency graphs, and calls the LLM. It can be resumed if interrupted.

```bash
repowise init [PATH] [OPTIONS]
```

```bash
# Current directory, Anthropic (default)
repowise init
```

```bash
# Specific path and provider
repowise init /path/to/repo --provider openai --model gpt-4o
```

```bash
# Fully offline with Ollama
repowise init --provider ollama --model llama3.2
```

```bash
# Preview cost before spending tokens
repowise init --dry-run
```

```bash
# Resume after an interruption
repowise init --resume
```

--------------------------------

### Initialize Single Repo

Source: https://github.com/repowise-dev/repowise/blob/main/docs/CLI_REFERENCE.md

Use this command to index a single codebase and generate wiki documentation. Navigate to your project directory before running.

```bash
cd your-project
repowise init
```

--------------------------------

### Codex MCP Server Configuration

Source: https://github.com/repowise-dev/repowise/blob/main/docs/CODEX.md

Example configuration for a Repowise MCP server within `.codex/config.toml`. This setup allows Repowise to act as an MCP server for Codex.

```toml
[mcp_servers.repowise]
command = "repowise"
args = ["mcp"]
cwd = "/absolute/path/to/repo"
startup_timeout_sec = 20

[features]
hooks = true
```

--------------------------------

### Start Repowise Server

Source: https://github.com/repowise-dev/repowise/blob/main/docs/AUTO_SYNC.md

Run the 'serve' command to start the Repowise server. This is necessary for handling GitHub webhooks. You can specify the host and port for the server to listen on.

```bash
repowise serve                          # http://localhost:7337
```

```bash
repowise serve --host 0.0.0.0 --port 8080  # custom bind
```

--------------------------------

### Repowise File Structure Example

Source: https://github.com/repowise-dev/repowise/blob/main/docs/internals/editor-files.md

Illustrates the CLAUDE.md file structure with user instructions and Repowise's auto-generated section, marked by REPOWISE:START and REPOWISE:END.

```markdown
# CLAUDE.md

<!-- Add your custom instructions below.
     Repowise will never modify anything outside the REPOWISE markers. -->
<!-- Examples: coding style rules, test commands, workflow preferences -->

[user's own content — untouched by repowise]

<!-- REPOWISE:START — Do not edit below this line. Auto-generated by Repowise. -->
## Codebase Intelligence — myrepo (Repowise)

[auto-generated content]
<!-- REPOWISE:END -->

```

--------------------------------

### Get Repository Health Dashboard

Source: https://github.com/repowise-dev/repowise/blob/main/plugins/claude-code/skills/code-health/SKILL.md

Use `get_health()` without targets for repository-level KPIs and a list of the lowest-scoring files. This is the starting point for general code health inquiries.

```python
get_health()
```

--------------------------------

### Get LLM Provider from Registry

Source: https://github.com/repowise-dev/repowise/blob/main/docs/architecture/implementation-deep-dive.md

Instantiates an LLM provider from the registry, automatically attaching default rate limiters. Uses lazy imports, so the provider's SDK is only installed when requested.

```python
provider = get_provider("anthropic", api_key="sk-...", model="claude-sonnet-4-6")
# Automatically attaches a RateLimiter with Anthropic defaults (50 RPM, 100k TPM)
```

--------------------------------

### Auto-setup MCP Server

Source: https://github.com/repowise-dev/repowise/blob/main/docs/MCP_TOOLS.md

Commands for automatically setting up the MCP server and installing proactive hooks. Use 'repowise init' for general setup and 'repowise init --codex' for Codex-specific configuration.

```bash
repowise init
```

```bash
repowise init --codex
```

--------------------------------

### Get Repository Overview using get_overview

Source: https://github.com/repowise-dev/repowise/blob/main/website/mcp-server.md

Obtain a high-level architecture summary of the indexed repository with get_overview. This includes key modules, entry points, tech stack, git health, and recent activity trends. It's recommended to call this at the start of any new task.

```python
get_overview()

Example response:
Repository: repowise
Architecture: Python monorepo (cli, core, server, web)
Entry points: packages/cli/src/repowise/cli/main.py
Tech stack: Python, FastAPI, SQLite, LanceDB, Next.js
Top hotspots: init_cmd.py (99.8th %ile), test_mcp.py (99.5th %ile)
Bus factor risk: git_indexer.py (1 author)
```

--------------------------------

### Config.yaml Example

Source: https://github.com/repowise-dev/repowise/blob/main/docs/CONFIG.md

Example configuration settings for Repowise, including LLM provider, model, embedder, reasoning mode, wiki style, and git analysis parameters.

```yaml
provider: anthropic                  # LLM provider
model: claude-sonnet-4-6             # Model identifier
embedder: gemini                     # Embedding provider
reasoning: auto                      # auto | off | minimal
wiki_style: comprehensive            # comprehensive | caveman | reference | tutorial
exclude_patterns:                    # Gitignore-style patterns
  - vendor/
  - "*.generated.*"
  - proto/
commit_limit: 500                    # Max commits per file for git analysis
follow_renames: false                # Track file renames in git history

```

--------------------------------

### Local Development Setup with uv

Source: https://github.com/repowise-dev/repowise/blob/main/docs/USER_GUIDE.md

Sets up the repowise environment for local development using the workspace lockfile and uv package manager.

```bash
git clone https://github.com/repowise-dev/repowise.git
```

```bash
cd repowise
```

```bash
uv sync --all-packages
```

```bash
uv run repowise --version
```

--------------------------------

### Team onboarding: Generate wiki

Source: https://github.com/repowise-dev/repowise/blob/main/docs/USER_GUIDE.md

Initializes Repowise to generate a full wiki for a new team member, using OpenAI as the provider.

```bash
repowise init --provider openai
```

--------------------------------

### Install OpenCode CLI

Source: https://github.com/repowise-dev/repowise/blob/main/docs/OPENCODE.md

Installs the OpenCode CLI using a curl script. Ensure you have bash and curl installed.

```bash
curl -fsSL https://opencode.ai/install | bash
```

--------------------------------

### Initialize OpenCode CLI

Source: https://github.com/repowise-dev/repowise/blob/main/docs/OPENCODE.md

Runs the OpenCode CLI for the first time to set up model providers and authentication. This step is necessary after installation.

```bash
opencode
```

--------------------------------

### Install repowise-server

Source: https://github.com/repowise-dev/repowise/blob/main/packages/server/README.md

Install the repowise-server package using pip or uv. This automatically installs FastAPI, uvicorn, mcp, apscheduler, cryptography, and repowise-core.

```bash
pip install repowise-server
```

```bash
uv pip install repowise-server
```

--------------------------------

### Install Command Rewrite Hook

Source: https://github.com/repowise-dev/repowise/blob/main/docs/USER_GUIDE.md

Install the command-rewrite hook to automatically rewrite noisy commands to `repowise distill <cmd>`, pending your approval. This hook can be installed via `repowise hook rewrite install` or by answering 'Yes' at the `repowise init` prompt.

```bash
repowise hook rewrite install
```

--------------------------------

### Install Post-Commit Hook

Source: https://github.com/repowise-dev/repowise/blob/main/docs/QUICKSTART.md

Install a post-commit hook for automatic synchronization of your repositories.

```bash
repowise hook install
```

--------------------------------

### Serve Repowise Web UI

Source: https://github.com/repowise-dev/repowise/blob/main/docs/QUICKSTART.md

Start the Repowise web UI and API server. Node.js 20+ enables automatic startup; otherwise, Docker may be required.

```bash
repowise serve
# API on http://localhost:7337, Web UI on http://localhost:3000
```

--------------------------------

### Install Repowise Claude Code Plugin

Source: https://github.com/repowise-dev/repowise/blob/main/website/claude-code-plugin.md

Run these commands in Claude Code to install the repowise plugin. It handles pip installation, MCP server registration, and loads slash commands automatically.

```bash
/plugin marketplace add repowise-dev/repowise-plugin
/plugin install repowise@repowise
```

--------------------------------

### Initialize with a Specific Wiki Style

Source: https://github.com/repowise-dev/repowise/blob/main/docs/WIKI_STYLES.md

Set a wiki style during the initial setup of a repository using the `--wiki-style` flag or the interactive prompt. The choice is saved in `.repowise/config.yaml`.

```bash
repowise init --wiki-style caveman
```

--------------------------------

### Verify Repowise Installation

Source: https://github.com/repowise-dev/repowise/blob/main/docs/USER_GUIDE.md

Checks if repowise has been installed correctly and displays its version or help information.

```bash
repowise --version
```

```bash
repowise --help
```

--------------------------------

### Contributing to Repowise

Source: https://github.com/repowise-dev/repowise/blob/main/README.md

Steps to set up the Repowise development environment. This includes cloning the repository, installing dependencies using `uv`, and running unit tests.

```bash
git clone https://github.com/repowise-dev/repowise
cd repowise
uv sync --all-packages
uv run repowise --version
uv run pytest tests/unit/
```

--------------------------------

### Initialize Repowise Interactively

Source: https://github.com/repowise-dev/repowise/blob/main/docs/CLI_REFERENCE.md

Starts an interactive repowise initialization process. Use this when you want to be prompted for configuration choices.

```bash
repowise init                                         # interactive
```

--------------------------------

### Install Repowise Core with pgvector

Source: https://github.com/repowise-dev/repowise/blob/main/packages/core/README.md

Install the core library with pgvector support for PostgreSQL deployments.

```bash
pip install "repowise-core[pgvector]"
```

--------------------------------

### Verify OpenCode CLI Installation

Source: https://github.com/repowise-dev/repowise/blob/main/docs/OPENCODE.md

Checks if the OpenCode CLI is installed and accessible in your system's PATH.

```bash
opencode --version
```

--------------------------------

### Start Repowise Frontend

Source: https://github.com/repowise-dev/repowise/blob/main/docs/USER_GUIDE.md

Run the Repowise frontend development server. Ensure it is running alongside the backend to avoid CORS errors.

```bash
npm run dev
```

--------------------------------

### Start MCP Server

Source: https://github.com/repowise-dev/repowise/blob/main/website/cli-reference.md

Starts the MCP server for AI editor integration. Defaults to stdio transport.

```bash
repowise mcp [PATH] [OPTIONS]
```

```bash
repowise mcp                              # stdio (Claude Code, Cursor, Cline)
```

```bash
repowise mcp --transport streamable-http  # HTTP on port 7338
```

```bash
repowise mcp --transport sse --port 7338  # legacy SSE
```

--------------------------------

### Coverage Configuration Example

Source: https://github.com/repowise-dev/repowise/blob/main/packages/core/src/repowise/core/analysis/health/coverage/README.md

Example of a Repowise configuration file (`.repowise/config.yaml`) showing options for coverage analysis, including auto-discovery, artifact globs, explicit paths, and path manipulation.

```yaml
coverage:
  auto_discover: true          # discover reports during indexing
  artifacts:                   # override the default discovery globs
    - coverage/lcov.info
  paths:                       # explicit report paths (skip discovery)
    - build/coverage/lcov.info
  format: lcov                 # force a parser (else content-sniffed)
  strip_prefix: build          # drop a leading prefix from report paths
  path_prefix: packages/web    # prepend a prefix to report paths
  reingest_on_update: false    # re-parse on every update (else reuse DB rows)
```

--------------------------------

### Initialize Repowise Documentation Generation

Source: https://github.com/repowise-dev/repowise/blob/main/docs/USER_GUIDE.md

Use this command to start the process of generating wiki documentation for your codebase. It can be run interactively or with full automation.

```bash
repowise init [PATH]
```

```bash
repowise init
```

```bash
repowise init --provider anthropic --model claude-sonnet-4-6 --yes
```

```bash
repowise init --provider codex_cli --codex --yes
```

```bash
repowise init --index-only
```

```bash
repowise init --provider openai --dry-run
```

```bash
repowise init --provider gemini --test-run
```

```bash
repowise init --provider openrouter --model openai/gpt-5 --reasoning minimal
```

```bash
repowise init -x vendor/ -x "*.gen.go" -x "**/__generated__/**"
```