See also: Config Reference · Architecture · Usage Guide
rebuild --help
rebuild version
Walk git history and test each commit.
rebuild walk REPO [OPTIONS]
| Option | Default | Description |
|---|---|---|
--days N |
30 |
Number of days to walk |
--date-from YYYY-MM-DD |
— | Start date |
--date-to YYYY-MM-DD |
— | End date |
--deploy METHOD |
auto |
none, docker-compose, auto, custom |
--output DIR |
.rebuild |
Output directory |
--health-url URL |
http://localhost:8000/health |
Health check endpoint |
--base-url URL |
http://localhost:8000 |
Base URL for endpoint testing |
--health-timeout N |
60 |
Health check timeout (seconds) |
--screenshots / --no-screenshots |
off | Capture screenshots with Playwright |
--dry-run |
off | Skip deploy, test endpoints on running stack |
--replay |
off | Replay mode — reuse existing containers |
--serve |
off | Auto-start HTTP server after walk |
--port N |
7821 |
Port for --serve |
--accelerator |
off | Use AcceleratedPipeline with DB snapshots |
Detect duplicate code fragments.
| Option | Default | Description |
|---|---|---|
--min-lines N |
6 |
Minimum lines per fragment |
--semantic |
off | Enable semantic (embedding) similarity |
--semantic-model NAME |
all-MiniLM-L6-v2 |
Sentence-transformers model |
--semantic-threshold F |
0.85 |
Similarity threshold (0–1) |
Build and display the service dependency graph.
Analyse function quality using git history and test results.
Build a vector search index from code fragments.
Semantic search in the vector index.
Cross-repository dependency and duplication analysis.
Generate a refactoring plan.
| Option | Default | Description |
|---|---|---|
--ai |
off | Use AI to enhance suggestions |
Execute the refactoring plan.
| Option | Default | Description |
|---|---|---|
--force |
off | Skip confirmation prompt |
Generate a PR description (requires AI key).
List installed scanner and reporter plugins.
rebuild plugins
rebuild plugins --verboseInitialise a new rebuild project.
rebuild init /path/to/repo
rebuild init /path/to/repo --force # overwrite existing filesServe walk results over HTTP.
rebuild serve --results-dir .rebuild --port 7821Print a summary of walk results.
rebuild report --results-dir .rebuildPrint the installed version.
rebuild version
# rebuild v0.1.23Launch the interactive terminal UI.
rebuild tuiRequires pip install "rebuild[tui]".
Ultra-fast walk using git worktrees and DB snapshots.
rebuild accelerator /path/to/repo --service backend --parallel 4 --smart