Skip to main content

Module constants

Module constants 

Source

Constants§

AGENTS_MD_FILE
Where devp skill --agent agents-md writes its marked block — the cross-tool convention read by Codex, Jules, Amp, Antigravity and others.
AGENT_SKILLS_SUBDIR
Subdirectory of an agent’s home where Agent Skills live, one directory per skill.
AMAZON_Q_RULES_FILE
Where devp skill --agent amazon-q writes its rules (Amazon Q Developer reads every file in .amazonq/rules/).
ANTIGRAVITY_RULES_FILE
Where devp skill --agent antigravity writes the per-repository rules — Antigravity (Google) reads workspace rules from .agent/rules/.
APP_NAME
Application name.
ATTRIBUTION_LINE
The one-line credit printed under interactive output.
AUTHOR
Author of dev-prune.
CACHE_CLEAR_TIMEOUT_SECS
Ceiling for one devp caches clear step.
CACHE_QUERY_TIMEOUT_SECS
Timeout for the “where does your cache live?” queries devp caches makes.
CLAUDE_HOME_DIR
Directory under the user’s home that marks a Claude Code installation.
CLINE_RULES_FILE
Where devp skill --agent cline writes its rules (Cline reads every file in the .clinerules/ directory).
CONFIG_DIR_NAME
Config directory name under user config root.
CONTINUE_RULES_FILE
Where devp skill --agent continue writes its rules (Continue reads every file in .continue/rules/).
COPILOT_INSTRUCTIONS_FILE
The shared file devp skill --agent copilot owns a marked block inside.
CURSOR_RULES_FILE
Where devp skill --agent cursor writes the per-repository rules.
DEFAULT_ALLOW_MANIFEST_REWRITE
Whether an adapter whose sync command edits tracked manifests may run it.
DEFAULT_AUTO_CONFIG
Default for whether link and init write a .devprune.json into repositories they register.
DEFAULT_AUTO_DAEMON
Whether the setup pass installs the OS scheduler.
DEFAULT_AUTO_HOOKS
Whether the setup pass installs the global Git auto-registration hooks.
DEFAULT_AUTO_HOOKS_CHAIN
Whether the setup pass installs the Git hooks in front of another tool’s.
DEFAULT_AUTO_SETUP
Whether dev-prune installs its missing integrations by itself.
DEFAULT_AUTO_UPDATE
Whether a known-newer release installs itself at the end of a prune pass. On by default — see Settings::auto_update.
DEFAULT_BUILD_IDLE_DAYS
Default idle threshold for build-tree directories, in days.
DEFAULT_CHECK_INTERVAL_DAYS
Default interval in days between background daemon prune runs.
DEFAULT_COMMAND_TIMEOUT_SECS
Default timeout in seconds for lockfile enforcement / CLI commands (10 minutes).
DEFAULT_IDLE_DAYS
Default idle threshold in days before a repository is eligible for pruning.
DEFAULT_MIN_SIZE_MB
Default size floor, in MiB, below which a bloat directory is left alone.
DEFAULT_REQUIRE_CONFIRMATION
Default setting for requiring interactive confirmation before pruning.
DEFAULT_SCAN_DEPTH
How far below a repository root project discovery descends, by default.
DEFAULT_UPDATE_CHECK
Whether the periodic release check runs. On by default — see Settings::update_check.
DEVPRUNE_IGNORE_FILE
Filename that, when present in a repo root, causes dev-prune to skip that repo entirely.
ENV_CONFIG_DIR_OVERRIDE
Global environment variable name to override config directory location.
ENV_NATIVE_ARCH
Windows environment variable that carries the machine’s architecture when the running process is emulated.
ENV_NO_AUTO_SETUP
Environment variable that suppresses the automatic setup pass entirely.
ENV_NO_TUI
Set to any value to keep every full-screen view from opening, so the line-by-line fallback runs instead.
ENV_OFFLINE
Environment variable that keeps the process off the network entirely — the release check and the extension-download fallback alike. Set by the test suites, useful on air-gapped machines; the durable per-user switch is devp config set update_check false.
EPHEMERAL_ANCESTORS
Directory names that mean “the contents of this are disposable”.
EPHEMERAL_REPO_PREFIXES
Repository directory names that mean the same thing, wherever they are.
GEMINI_MD_FILE
The shared file devp skill --agent gemini owns a marked block inside — the Gemini CLI reads one context file per repository.
GIT_DUBIOUS_OWNERSHIP
The phrase Git uses when it refuses a working tree owned by another account.
GIT_NOT_A_REPOSITORY
The phrase Git uses when the path it was pointed at is not a working tree at all.
HISTORY_STARTS_AT
The release that started recording per-repository totals and the pass history.
HOMEBREW_TAP
The Homebrew tap that carries the formula, as brew tap takes it. Not homebrew-core: plain brew install dev-prune resolves there, and that has a notability bar this project has not cleared. See docs/DISTRIBUTION.md.
HOMEPAGE_URL
Project homepage.
INSTALL_PS1_URL
The PowerShell installer — same two callers as INSTALL_SH_URL.
INSTALL_SH_URL
The shell installer, printed as an upgrade command and re-run by devp update --install when the running binary came from it.
JSON_SCHEMA_URL
Public URL for the JSON Schema used by IDEs for .devprune.json IntelliSense.
JUNIE_GUIDELINES_FILE
The shared file devp skill --agent junie owns a marked block inside — JetBrains Junie reads one guidelines file, not a directory.
KILOCODE_RULES_FILE
Where devp skill --agent kilocode writes its rules (Kilo Code reads every file in .kilocode/rules/).
KIRO_STEERING_FILE
Where devp skill --agent kiro writes its rules (Kiro reads every file in .kiro/steering/).
LATEST_RELEASE_API_URL
GitHub API endpoint for the latest published release.
MACOS_LAUNCHD_LABEL
Label of the macOS LaunchAgent the daemon registers (also names its plist file).
MAX_SCAN_DEPTH_LIMIT
Upper bound accepted for scan_depth.
MSRV
Minimum supported Rust version, derived dynamically from rust-version in Cargo.toml — which is the single source of truth for the MSRV. Only cargo install users ever meet it; every other channel ships a prebuilt binary.
OPENVSX_URL
The Open VSX listing, which is what VSCodium, Cursor and Windsurf resolve against.
PER_REPO_CONFIG_FILE
Name of the structured per-repository configuration file stored inside repo roots.
PRUNE_HISTORY_LIMIT
How many prune passes devp stats keeps a summary of.
READING_MACHINE
Shown while devp trust and the configurator ask the OS about the scheduler and Git hooks, then overwritten in place. Kept here because its width is what the erase writes over, so the two must not be able to drift apart.
REGISTRY_FILENAME
Name of the registry JSON file.
RELEASES_URL
GitHub releases page, shown whenever an upgrade is relevant.
RELEASE_DOWNLOAD_BASE
Where a release’s assets live, with {tag} standing in for v1.4.0.
REPO_URL
Canonical source repository.
RESTORE_RATE_MIN_MILLIS
The shortest restore worth learning a throughput from, in milliseconds.
RESTORE_RATE_SAMPLE_CAP
How many restore measurements one adapter’s throughput average is worth.
ROO_RULES_FILE
Where devp skill --agent roo writes its rules (Roo Code reads every file in .roo/rules/).
RULES_BLOCK_END
RULES_BLOCK_START
Markers around the block in COPILOT_INSTRUCTIONS_FILE that dev-prune manages. Everything outside them belongs to the user and is never touched.
SCHEDULER_HIDDEN_REFUSED_MARKER
Marker file (in the config directory) recording that this machine’s Task Scheduler refused the hidden (S4U) task registration, so setup keeps the visible task instead of retrying the upgrade on every pass.
SCOOP_BUCKET_NAME
The Scoop bucket name and the repository behind it. scoop bucket add takes both, and the name is what scoop install then resolves dev-prune against.
SCOOP_BUCKET_URL
Repository URL for SCOOP_BUCKET_NAME.
STATUS_SCAN_MAX_THREADS
Ceiling on the threads devp status uses to size repositories.
STATUS_SCAN_THREADS_ENV
Overrides the computed status-scan thread count. Clamped to STATUS_SCAN_MAX_THREADS; 1 forces a sequential scan.
STATUS_SCAN_THREADS_PER_CORE
Threads per reported core for the status scan. Above one because the scan waits on the disk far more than on the CPU; well below what the disk will queue, because past that point the extra threads only take turns.
TOOL_OUTPUT_MAX_LINES
How many lines of a failed command’s output are relayed into a report.
TRAE_RULES_FILE
Where devp skill --agent trae writes its rules (Trae reads every file in .trae/rules/).
TROUBLESHOOTING_URL
Documentation URL for troubleshooting lockfile and pruning failures.
UPDATE_CHECK_INTERVAL_DAYS
Default interval, in days, between automatic release checks.
UPDATE_CHECK_TIMEOUT_SECS
Default timeout for the release check. Short on purpose — this is a convenience, and a user waiting on a hung socket is worse than not knowing. Override with devp config set update_check_timeout_secs when a proxy needs longer.
UPDATE_DOWNLOAD_TIMEOUT_SECS
Timeout for downloading a release binary in devp update --install.
VERSION
Application crate version derived dynamically from Cargo.toml.
VSCODE_EXTENSION_ID
Marketplace identifier (publisher.name) of the VS Code extension, as understood by code --install-extension.
VSCODE_MARKETPLACE_URL
Where a person can read about the extension before installing it.
WINDOWS_HIDDEN_BIN
File name of the windowless scheduler binary — dev-prune.exe with its PE subsystem set to GUI, the same relationship pythonw.exe has to python.exe. Generated locally beside the managed binary; never shipped in any archive.
WINDOWS_TASK_NAME
Name of the Windows Task Scheduler task the daemon registers.
WINDSURF_RULES_FILE
Where devp skill --agent windsurf writes the per-repository rules.
WINGET_PACKAGE_ID
The WinGet package identifier, as published in packaging/winget/ and in the manifests submitted to microsoft/winget-pkgs. devp update and devp uninstall name it back to the user, so a typo here sends someone to a command that does not resolve.
ZED_RULES_FILE
The shared file devp skill --agent zed owns a marked block inside. Zed reads .rules ahead of every other convention, so a repository that also has an AGENTS.md still needs this one.

Statics§

LONG_VERSION
The body of devp --version.

Functions§

release_asset_name
The release-asset name for one platform, without the .sha256 suffix.