[!NOTE]
v0.1.0, the first usable release. duscope scans, answers top, tree,
by-type and stale from the scan, prints one JSON envelope and draws a
treemap in the terminal. The index and its history, the MCP server and the
interactive treemap arrive in later releases, as the list below marks.
duscope is a disk-usage analyzer for macOS and Linux. It scans a directory tree
once, in parallel, and:
Fast, queryable disk-usage analyzer with JSON output and an MCP server
स्टार
2
टूल
—
अपटाइम
—
draws the tree as a coloured treemap in the terminal (static now; interactive
later);
answers the questions that free space: the largest directories and files,
large files untouched for months, bytes by file type;
prints one versioned JSON envelope, sized to fit the output limits of scripts
and AI agents;
will keep each scan in a SQLite index with precomputed subtree totals, answer
from it in milliseconds, compare two scans and take read-only SQL (v0.2), and
serve the same read-only operations to agents as a stdio MCP server (v0.3).
Its sizes are what deleting would free: hard links count once on every
filesystem, and it accounts for APFS clones and firmlinks on macOS and for btrfs
and XFS reflinks, subvolumes and bind mounts on Linux. Linux and macOS are both
first-class, with one binary, one set of commands and one JSON format.
A tour
Each command scans the tree it is given and answers from that scan. The output
below is from the fixture tree duscope's tests build (just fixtures), a
made-up home directory, on macOS (APFS); a terminal shows it in colour. On Linux
some allocated sizes differ, and the thread count at the end of the summary
line is the machine's default. Paths in the home directory are shortened to ~
here; duscope prints them in full.
top lists the largest directories. A directory holding 80% of its parent's
bytes is cut through to the child that holds them, so the row says where the
space is:
Scripts take --plain (tab-separated, sizes in bytes) or --json, the
envelope every verb shares; agents get JSON without asking. Nothing but the
payload reaches stdout, and the summary line goes to stderr (the two blocks
below leave it out):
duscope alone, or duscope scan ~, draws the treemap: a box per folder, a
tile per file, coloured by class, with the legend and the next commands below.
duscope man prints the manual page, and duscope completions bash (or zsh,
fish, elvish, powershell) the completion script.
What it never does
It never follows a symbolic link, unless given --follow-symlinks.
It never reads a file's contents, only names and metadata (and, for --exclude-caches, the 43-byte signature of a CACHEDIR.TAG). It does read the system's own description of the disk's layout: /usr/share/firmlinks on macOS, /proc/self/mountinfo on Linux.
It never writes inside the tree it scans.
It never deletes without being told: v0.1.0 has no command that deletes, and the clean of a later release is a dry run unless given --yes, and moves files to the Trash by default.
It never opens a network connection: no telemetry, no update checks.
Install
GitHub Releases and crates.io carry each release from v0.1.0 (v0.0.1 was the
pre-release placeholder). The other channels open with the release each one
names.
GitHub Releases
Prebuilt binaries for macOS (Apple silicon and Intel) and Linux (x86_64 and
arm64, statically linked with musl), built by cargo-dist with build
attestations. The shell installer picks the archive for the machine and
installs duscope into ~/.cargo/bin:
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/kawadeomkar/duscope/releases/latest/download/duscope-installer.sh | sh
To check a downloaded archive was built by this repository's release workflow:
On macOS and Linux, with bottles, from the tap kawadeomkar/homebrew-tap:
brew install kawadeomkar/tap/duscope
Once duscope meets homebrew-core's notability bar, the formula moves to
homebrew-core and brew install duscope works without the tap.
Debian and Ubuntu
.deb packages for amd64 and arm64, attached to each GitHub release from
v0.1.0. They install one static binary, which runs on any glibc:
sudo apt install ./duscope_<version>_amd64.deb
A signed apt repository (not yet live: phase 5, before 1.0) will then make it
sudo apt install duscope on Debian 12 and later and Ubuntu 22.04 and later,
once the repository is added as docs/apt.md will describe.
crates.io
cargo install duscope --locked
Cargo builds it with its default release settings: duscope's release profile
(link-time optimisation, symbols stripped) applies only to builds inside this
repository, so the binary is larger than the prebuilt ones.
From source
It needs rustup, which installs the toolchain pinned in
rust-toolchain.toml:
अभी टूल सूची नहीं है। रिमोट सर्वर को पहले हेल्थ चेक के बाद सूची मिलती है।
FAQ
सवाल
Duscope कैसे इंस्टॉल करें?
इस पेज पर Cursor, Claude Desktop, Claude Code या VS Code के लिए stdio कॉन्फ़िग कॉपी करें। यह पब्लिशर का इंस्टॉल इस्तेमाल करता है, PlugMCP प्रॉक्सी नहीं।
क्या Duscope के लिए API key चाहिए?
इस रिकॉर्ड में कोई ज़रूरी एनवायरनमेंट वेरिएबल दर्ज नहीं है।
Duscope कौन सा ट्रांसपोर्ट इस्तेमाल करता है?
Duscope stdio पर लोकल चलता है।
Duscope की पिछली जाँच कब हुई थी?
पिछली जाँच 2026-11-14 को हुई। Fast, queryable disk-usage analyzer with JSON output and an MCP server