repowiseOther commands
One-shot utilities: costs, coverage, dead-code, security scan, doctor, export, generate-claude-md, telemetry, login/logout/whoami, augment, delete.
repowise costs
LLM cost history. Aggregates calls made during init and update.
repowise costs [PATH] [OPTIONS]| Parameter | Type | Default | Description |
|---|---|---|---|
--since | string | — | Only show costs since this date (ISO format, e.g. 2026-01-01). |
--by | string | operation | Group by: operation, model, day |
--repo-path | string | — | Repository path. Defaults to the current directory. |
--repo | string | — | Workspace repo alias to query (implies workspace mode). |
--all | boolean | false | In workspace mode, sum costs across every repo instead of just the primary. |
--no-workspace | boolean | false | Force single-repo mode even when invoked from a workspace. |
--format | string | table | Output format. |
repowise costs
repowise costs --since 2026-01-01 --by model
repowise costs --by day
repowise costs --repo backend --format json
repowise costs --allrepowise coverage
Ingest and inspect test-coverage reports. Coverage is auto-discovered and
ingested during init / update; this group is the manual path, point it
at a report (or let it auto-discover one) to populate per-file line/branch
coverage, which clears untested_hotspot findings for tested files.
repowise coverage add [PATHS...] # ingest one or more reports
repowise coverage status # show currently ingested coverage| Parameter | Type | Default | Description |
|---|---|---|---|
--path | string | — | Repo path (defaults to cwd / workspace primary). |
--format | string | — | Force a parser instead of auto-detecting: lcov, cobertura, clover, repowise-json |
--verbose / -v | boolean | false | Show debug logs from the pipeline. |
repowise coverage add # discover coverage/lcov.info etc.
repowise coverage add coverage/lcov.info
repowise coverage add web.lcov api.lcov # merged, hit wins
repowise coverage statusrepowise dead-code
Detect unused code via the dependency graph. No LLM calls.
repowise dead-code [PATH] [OPTIONS]| Parameter | Type | Default | Description |
|---|---|---|---|
--min-confidence | number | 0.4 | Minimum confidence threshold. |
--safe-only | boolean | false | Only show safe_to_delete=True findings. |
--kind | string | — | unreachable_file, unused_export, unused_internal, zombie_package |
--format | string | table | Output format: table, json, md |
--include-internals | boolean | false | Detect unused private/internal symbols. |
--include-zombie-packages | boolean | true | Detect monorepo packages with no importers. |
--no-unreachable | boolean | false | Skip detection of unreachable files. |
--no-unused-exports | boolean | false | Skip detection of unused exports. |
--repo | string | — | Workspace repo alias to analyze (implies workspace mode). |
--no-workspace | boolean | false | Force single-repo mode even when invoked from a workspace. |
repowise dead-code
repowise dead-code --safe-only
repowise dead-code --kind unused_export --format json
repowise dead-code --include-internals --min-confidence 0.8The agent-facing equivalent is get_dead_code.
repowise security scan
Scan for security signals (secrets, risky patterns) and persist findings to the local store.
repowise security scan [OPTIONS]| Parameter | Type | Default | Description |
|---|---|---|---|
--history | boolean | false | Scan the full git history, not just the current working tree. |
--since | string | — | Lower git revision bound (exclusive). Defaults to all history. |
--to | string | — | Upper git revision bound (inclusive). Defaults to all history/HEAD. |
--path | string | — | Repo path (defaults to cwd / workspace primary). |
--all-patterns | boolean | false | History mode: also report code-smell patterns (eval, os.system, weak hashes, ...). By default history mode reports only leaked-secret patterns. |
--format | string | table | Output format. json is the machine-readable summary. |
repowise security scan --history # walk the whole history
repowise security scan --history --since v1.0 --to HEAD
repowise security scan --history --all-patterns --format jsonWithout --history this is a no-op stub: working-tree scanning already runs
automatically during repowise init/repowise update. --history is what
finds secrets that were committed and later deleted, something the
working-tree scan cannot see. Findings land in the security_findings table
and show up in repowise server's security API and UI. Re-running is
idempotent.
repowise doctor
Health check. Validates: git repo, .repowise/ directory, database,
state.json, provider config, stale pages, and store consistency
(SQL/vector/FTS sync).
repowise doctor [PATH] [OPTIONS]| Parameter | Type | Default | Description |
|---|---|---|---|
--repair | boolean | false | Attempt to fix detected mismatches. |
repowise doctor
repowise doctor --repairFirst port of call when something looks wrong. --repair fixes
the common mismatches automatically.
CLI version check
doctor also prints a best-effort CLI version row that compares your
installed CLI against the latest release on PyPI.
When an update is available it shows the right upgrade command for your
install method (uv tool upgrade repowise, pipx upgrade repowise, or
python -m pip install -U repowise). It surfaces both the repowise resolved
on your PATH and the command that launched the current process, since these
can differ, which is useful when an MCP client is running a stale executable.
This row is advisory only: it never updates anything automatically, never
fails doctor when PyPI is unreachable, and an unparsable latest version is
reported as "unknown" rather than a false "up to date".
After upgrading, restart Claude/Codex/Cursor or any MCP client so it picks up the new executable.
repowise whats-new
Show release notes for repowise versions you haven't seen yet. By default it lists releases newer than the last one you viewed, then records the current version as seen. Works offline from the changelog bundled with the install.
repowise whats-new [OPTIONS]| Parameter | Type | Default | Description |
|---|---|---|---|
--version | string | — | Show notes for a single release (e.g. 0.21.0). |
--all | boolean | false | Show the full changelog history. |
repowise whats-new # what changed since you last looked
repowise whats-new --version 0.21.0 # one specific release
repowise whats-new --all # full historyrepowise update shows a short "what's new" panel automatically after you
upgrade to a newer version, and both update and serve print a one-line,
non-blocking notice when a newer release is available. See
Upgrading for the full upgrade flow.
repowise export
Export wiki pages to files.
repowise export [PATH] [OPTIONS]| Parameter | Type | Default | Description |
|---|---|---|---|
--format | string | markdown | Output format: markdown, html, json, structurizr. structurizr writes one Structurizr DSL file describing the architecture instead of a directory of wiki pages. |
--output / -o | string | .repowise/export | Output directory. For --format structurizr, a path ending in .dsl names the file itself. |
--full | boolean | false | Include decisions, dead code, git metadata, and provenance in the JSON export. |
--standalone | boolean | false | structurizr only: emit a complete workspace with default views instead of a model fragment to include from your own workspace.dsl. |
--components | boolean | false | structurizr only: include the component level (one box per directory). |
--no-externals | boolean | true (externals included) | structurizr only: leave third-party dependencies out of the model. |
--force | boolean | false | structurizr only: overwrite the output file even if repowise did not write it. --standalone targets workspace.dsl, which may be your own. |
repowise export
repowise export --format html -o ./docs/wiki
repowise export --format json --full -o /tmp/backup
repowise export --format structurizr -o architecture.dsl
repowise export --format structurizr --standalone --components -o workspace.dslrepowise generate-claude-md
Regenerate CLAUDE.md from the index. Two-section file: a custom
section above the markers (never modified) and the
repowise-managed section (auto-updated).
repowise generate-claude-md [PATH] [OPTIONS]| Parameter | Type | Default | Description |
|---|---|---|---|
--output | string | — | Write to a custom path. Default: .claude/CLAUDE.md |
--stdout | boolean | false | Print to stdout instead of writing a file. |
--workspace / -w | boolean | false | Generate workspace-level CLAUDE.md at the workspace root. |
repowise generate-claude-md
repowise generate-claude-md --workspace
repowise generate-claude-md --stdout > preview.mdrepowise telemetry
Inspect and control anonymous, opt-out usage telemetry.
repowise telemetry status # show whether telemetry is enabled, and why
repowise telemetry enable
repowise telemetry disablerepowise login
Sign in to your hosted repowise.dev account. Unrelated to LLM provider keys
(--provider/--model elsewhere). This adds the hosted layer: indexed
repos on repowise.dev, reindex from local tools, and account status in
doctor. Every local feature works without signing in.
Sign-in is browser-based OAuth with PKCE by default: the command opens the
hosted consent page and stores tokens at ~/.repowise/credentials.json.
| Parameter | Type | Default | Description |
|---|---|---|---|
--with-token | boolean | false | Paste a personal API key (rw_live_...) instead of using the browser. For SSH/headless machines. |
--device-name | string | — | Label this machine in your connected apps (default: hostname). |
repowise login # browser sign-in
repowise login --with-token # headless, paste an API key
repowise login --device-name "build-box"repowise logout
Sign out of your Repowise account on this machine (best-effort server-side revocation, local credentials always removed).
repowise logoutrepowise whoami
Show the Repowise account this machine is signed in to.
repowise whoamirepowise augment
Internal hook command. Runs as a Claude Code PreToolUse /
PostToolUse hook to enrich Grep and Glob calls with related
files, top symbols, importers, and dependencies. Detects git commits
and notifies when the wiki is stale.
repowise augment # stdin hook modeDon't invoke augment directly. repowise init wires it into
~/.claude/settings.json automatically.
repowise delete
Delete a repository's stored index and generated data (not the source
files). Interactive picker when REPO_ID is omitted.
repowise delete [REPO_ID] [OPTIONS]| Parameter | Type | Default | Description |
|---|---|---|---|
--path / -p | string | — | Path to the repository directory. |
--force / -f | boolean | false | Skip the confirmation prompt. |
repowise delete # pick from a list
repowise delete abc123def456 # delete by repo id
repowise delete --path ../backend --forceThis only removes what's in .repowise/wiki.db (pages, FTS index) for the
chosen repo. For a full cleanup of everything repowise has written for a
repo, including agent wiring and machine-wide state, see
repowise uninstall.
Uninstall: remove repowise
Remove repowise from this repo, and optionally from this machine, with a full inventory of every path it ever wrote.
MCP tools: overview
The small, curated set of MCP tools repowise exposes to Claude Code and any MCP-compatible AI agent. Task-shaped, batched, and built to collapse long tool-call chains into one round-trip.