Enum Commands 

pub enum Commands {
    Init {
        paths: Vec<String>,
    },
    Link {
        path: String,
        quiet: bool,
    },
    Unlink {
        path: String,
        missing: bool,
    },
    Undo,
    Run {
        target_path: Option<String>,
        daemon: bool,
        only: Option<String>,
        skip: Option<String>,
        min_size: Option<u64>,
        except: Option<String>,
        json: bool,
        explain: bool,
    },
    Status {
        top: Option<u64>,
        drift: bool,
        json: bool,
    },
    Stats {
        json: bool,
    },
    Trust {
        json: bool,
        fix_ownership: bool,
        yes: bool,
    },
    Completions {
        shell: Shell,
    },
    Man {
        command: Option<String>,
        dir: Option<String>,
        roff: bool,
    },
    Caches {
        json: bool,
        action: Option<CachesAction>,
    },
    Config {
        action: Option<ConfigAction>,
    },
    Restore {
        path: Option<String>,
        last_run: bool,
    },
    Update {
        offline: bool,
        install: bool,
    },
    Skill {
        agent: Option<AgentEditor>,
    },
    Setup {
        status: bool,
    },
    Doctor {
        path: Option<String>,
        fix: bool,
    },
    Install {
        channel: Option<TargetChannel>,
        dry_run: bool,
    },
    Uninstall {
        deep: bool,
    },
}

Variants

Init

Workspace onboarding & discovery: crawl paths for Git repositories and register them.

Fields

paths: Vec<String>

Paths to scan for Git repositories (defaults to current directory).

Link

Register a single Git repository for pruning (defaults to current directory .).

Fields

path: String

Path to the Git repository to register.

quiet: bool

Suppress output and skip repos that set disable_hooks. Used by the Git hook.

Unlink

Remove a repository from the dev-prune registry (does not delete workspace files).

Fields

path: String

Path to the Git repository to unregister.

missing: bool

Unregister every path that no longer exists, instead of one named repository.

Undo

Revert the most recent init or link action.

Run

Run a prune pass across all registered repositories or a target directory (devp run .).

Fields

target_path: Option<String>

Optional target workspace path. If omitted, runs across all registered repositories.

daemon: bool

Mark this as the scheduled background pass. Repositories that set disable_daemon in .devprune.json are skipped. Set by the installed scheduler.

only: Option<String>

Act only on these package managers (comma-separated), e.g. --only npm,pnpm. Unknown names are an error.

skip: Option<String>

Leave these package managers alone (comma-separated), e.g. --skip cargo.

min_size: Option<u64>

Ignore bloat directories smaller than this many MiB. Overrides min_size_mb.

except: Option<String>

Prune everything except these repositories (comma-separated paths or names).

The safe way to express “clean up but keep the API project”: that project is never verified, never deleted and never reinstalled, instead of being pruned and then restored over the network.

json: bool

Emit one JSON document instead of the human report. Implies non-interactive.

explain: bool

Explain every decision instead of pruning: each repository and directory, with the reason it would or would not be touched — including the states a normal pass keeps quiet about (still active, opted out, under the size floor). Read-only; nothing is verified or deleted.

Status

View system dashboard: registered repos, background daemon, Git hooks & space metrics.

Fields

top: Option<u64>

Show only the N repositories with the most reclaimable space.

The dashboard lists every registered repository, which on a machine with a hundred of them buries the handful actually worth pruning. Applies to the TUI, the plain table and --json alike.

Zero is rejected up front: “show the top 0” can only be a typo, and an empty dashboard that looks like an empty registry is worse than a usage error.

drift: bool

Report lockfile drift instead of the dashboard: environments holding packages their lockfile never recorded — the installs a prune would refuse to delete because nothing could bring them back.

A pure read: no package manager runs, nothing is written. Checked where a file-level comparison exists — npm, uv and venv projects.

json: bool

Emit the dashboard as one JSON document instead of the TUI or text table.

Stats

Show lifetime space reclaimed, recent prune passes, and the biggest repositories.

Fields

json: bool

Emit the figures as one JSON document instead of the text report.

Trust

Report what dev-prune is allowed to do on this machine, and what it has been given permission to do.

Fields

json: bool

Emit the report as one JSON document instead of the table.

fix_ownership: bool

Let Git read registered repositories it currently refuses on ownership.

yes: bool

Answer yes to the confirmation --fix-ownership asks.

Completions

Print a shell completion script for bash, zsh, fish, PowerShell or elvish.

Fields

shell: Shell

Shell to generate for.

Man

Print or write man pages, generated from the same definitions --help prints.

Fields

command: Option<String>

The command whose page to read, e.g. devp man run. Omit for the contents page.

dir: Option<String>

Write devp.1 plus one devp-<command>.1 per subcommand into this directory, instead of rendering the main page to stdout.

roff: bool

Print the roff source even when stdout is a terminal, instead of the readable manual.

Caches

Report the size of every package manager cache on this machine (read-only unless you ask for clear).

Fields

json: bool

Emit the report as one JSON document instead of the table.

Global within caches so it can be written after the subcommand too — devp caches clear npm --json is what everyone types.

action: Option<CachesAction>

Config

Manage global settings, background daemon, Git hooks, custom icons, or per-project .devprune.json.

Fields

action: Option<ConfigAction>

Restore

Restore dependencies in a project using its lockfile (npm ci, pnpm install, uv sync).

Fields

path: Option<String>

Path to the project to restore (defaults to current directory).

last_run: bool

Put back exactly what the most recent prune pass deleted, in every repository it touched. The undo for a run.

Update

Print the installed version, check for a newer release, and show how to upgrade.

Fields

offline: bool

Skip the release check for this run. The check is the only thing in dev-prune that opens a network connection; devp config set update_check false turns it off for good.

install: bool

Download and install the newer release, through whichever package manager installed this copy (cargo, npm, uv, pipx, or the installer script). Needs the network, so it cannot be combined with --offline.

Skill

Export SKILL.md and display ready-to-copy AI Agent onboarding & skill import prompts.

Fields

agent: Option<AgentEditor>

Write rules for one editor’s agent into the current repository instead. Each value below names the exact file it writes. Five of them — agents-md, copilot, gemini, junie, zed — share a file with other tools, so dev-prune owns a marked block inside it and leaves every byte outside the markers as found. Claude Code needs no per-repo file: plain devp skill installs its skill globally.

Setup

Install whatever dev-prune integration is missing: alias, SKILL.md, Git hooks, scheduler.

Fields

status: bool

Report what is installed without changing anything.

Doctor

Diagnose the installation, or one repository if given a path (devp doctor .).

Fields

path: Option<String>

Repository to diagnose. Omit to check the installation itself.

fix: bool

Repair what the installation check finds broken: refresh a stale or missing devp twin, re-export SKILL.md, re-register a scheduler or Git hooks whose binary moved, and drop registry entries whose repository is gone.

Repairs only what was installed and has since broken — it never installs an integration that was never set up (that is devp setup), and it cannot fix a corrupt registry file, which needs a human decision.

Install

Move this install to another package manager: devp install --channel uv.

Fields

channel: Option<TargetChannel>

The package manager to move this installation to. Omit to print which one owns the running copy, and the names this flag accepts.

dry_run: bool

Print the commands that would run, and run none of them.

Uninstall

Remove dev-prune: scheduler, hooks, PATH entry, agent skill, and every copy of the binary.

Fields

deep: bool

Perform a deep uninstall (wipe configuration folder and .devprune.json files).

Trait Implementations

impl Debug for Commands

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl FromArgMatches for Commands

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut<'b>( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Subcommand for Commands

fn augment_subcommands<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_subcommands_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

fn has_subcommand(__clap_name: &str) -> bool

Test whether Self can parse a specific subcommand