git-slop 0.16.4

A deterministic repository token-defragmenter for humans and AI agents.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120

.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH git-slop 1  "git-slop 0.16.4"
.SH NAME
git\-slop \- Find the files that cost too much context.
.SH SYNOPSIS
\fBgit\-slop\fR [\fB\-\-repo\fR] [\fB\-\-error\-format\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] <\fIsubcommands\fR>
.SH DESCRIPTION
Find the files that cost too much context.
.SH OPTIONS
.TP
\fB\-\-repo\fR \fI<PATH>\fR
Repository or path inside a repository to analyze
.TP
\fB\-\-error\-format\fR \fI<ERROR_FORMAT>\fR [default: human]
Render runtime errors as human text or stable JSON
.br

.br
\fIPossible values:\fR
.RS 14
.IP \(bu 2
human
.IP \(bu 2
json
.RE
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
\fB\-V\fR, \fB\-\-version\fR
Print version
.SH SUBCOMMANDS
.TP
git\-slop\-init(1)
Scaffold .slop/ config, ignore rules, and state directories
.TP
git\-slop\-find(1)
Scan the repository and generate hotspot reports
.TP
git\-slop\-show(1)
Show metrics and reasons for one file or folder
.TP
git\-slop\-explain(1)
Explain why selected hotspots or structural findings are expensive
.TP
git\-slop\-plan(1)
Propose bounded maintenance slices from the current detector report
.TP
git\-slop\-policy(1)
Manage declarative policy packs used only by the optional advisor
.TP
git\-slop\-advise(1)
Build provider\-free policy context or validate an existing advice artifact
.TP
git\-slop\-check(1)
Evaluate an existing report against CI thresholds
.TP
git\-slop\-compare(1)
Compare two existing schema\-5 reports without rerunning the detector
.TP
git\-slop\-baseline(1)
Manage named comparison baselines in Git\-private runtime storage
.TP
git\-slop\-report(1)
Validate or inspect the versioned report contract
.TP
git\-slop\-sarif(1)
Export action\-queue findings from an existing schema\-5 report as SARIF
.TP
git\-slop\-health(1)
Render repository health for CI summaries, annotations, or automation
.TP
git\-slop\-config(1)
Inspect or migrate effective configuration
.TP
git\-slop\-doctor(1)
Diagnose repository readiness and optionally write a redacted bundle
.TP
git\-slop\-list(1)
List findings, relationships, clusters, or profiles
.TP
git\-slop\-prune(1)
Remove old immutable run snapshots according to retention policy
.TP
git\-slop\-cache(1)
Inspect or prune the packed token cache
.TP
git\-slop\-completions(1)
Generate shell completion source
.TP
git\-slop\-man(1)
Generate the roff manual from the live Clap command tree
.TP
git\-slop\-reference(1)
Generate Markdown command reference from the live Clap command tree
.TP
git\-slop\-html(1)
Write a self\-contained, local, searchable HTML report
.TP
git\-slop\-version(1)
Print version information
.TP
git\-slop\-build\-info(1)
Print package and source\-build provenance
.TP
git\-slop\-schema(1)
Print a published JSON Schema for a machine contract
.TP
git\-slop\-help(1)
Print this message or the help of the given subcommand(s)
.SH EXTRA
QUICK START:
  git slop find                       Run a safe first scan
  git slop health                     Review repository health
  git slop list interventions         Review maintenance candidates
  git slop html                       Build an interactive local report
  git slop init                       Adopt durable reports and ignore rules
.SH VERSION
v0.16.4