Expand description
disky core — typed query + render + scan layers shared by the CLI, the TUI
and the disky-mcp server.
Stability: the JSON record shapes exposed by query are part of the
agent-facing contract; bump query::SCHEMA_VERSION on any breaking
change.
Modules§
- cleanup
- Find — and optionally remove — well-known disk-hoggy directories
(
node_modules,target,__pycache__, …) discovered in a snapshot. - config
- Layered configuration: built-in defaults → file → env → CLI.
- db
- duration
- Tiny duration parser. Accepts shapes like
30d,2w,6mo,1y,48h,90m. No mixed units; whole numbers only. - envelope
- Parse a disky JSON envelope from any reader (stdin, file, byte slice).
- exit
- filter
- Predicate engine for
disky filter. Tiny hand-rolled tokenizer + evaluator over a small DSL:<field> <op> <literal>connected by optionalAND. - ignore
.diskyignoreloader — gitignore-style ergonomics, additive only.- pattern
- Pattern classifier for directory size-over-time samples.
- policy
- restic-style snapshot retention policy.
- predict
- Linear extrapolation of disk fill-by date.
- query
- render
- scan
- schema
- Static JSON-Schema-ish descriptor for disky’s machine-facing surface.
Emitted via
disky schemaso agents can bind to commands and output shapes without prompt-engineering. - snapshots