thevibeworks/deva/deva-clean

Claude Code and agent skill by thevibeworks/deva

Trust tier 2
  • community
LLM review pending
Source check pending

Checking that the SKILL.md file is still in the repository.

Disk cleanup for deva container workspaces - reclaim space without touching bind mounts or unpushed work. Use when the user wants disk space reclaimed in a deva workspace, asks to remove stale worktrees, or a disk-full symptom traces into the workspace. Deleting a single known build dir needs no skill - just delete it.

Install

npx vskill@latest install thevibeworks/deva/deva-clean

SKILL.md

The same SKILL.md was published earlier as thevibeworks/deva/deva-clean.

deva-clean: mount-safe workspace disk cleanup

A deva workspace mixes two kinds of directories that look identical in ls: bind mounts declared in .deva (live host repos) and local dirs created during work (git worktrees, node_modules, package stores). rm -rf on the wrong one destroys a live repo on the host. And because the workspace root is itself a host mount, local dirs still consume host disk - usually the disk that is actually full.

Two passes. Pass one is deterministic and scripted; pass two executes only what got approved.

Pass one: triage

Run the bundled script - read-only, emits the tiered plan, never deletes:

scripts/triage.sh [workspace] [--fetch]

It maps mounts from /proc/mounts (ground truth - .deva drifts), shows which disk is under pressure, walks the non-mount dirs, gives every candidate four verdicts (type, dirty, pushed, freshness), and finds stale worktree metadata in the mounted parent repos. Verdict semantics live in the script header; two encode traps worth knowing:

  • The pushed test is live ls-remote SHA comparison plus ancestry in

the default branch - never upstream config. A branch created off origin/develop shows "ahead 1" while never pushed itself.

  • MERGED is monotonic, provable even against stale refs. Absence is

not: a branch absent on remote with stale refs is UNVERIFIED, not safe. Rerun with --fetch for a definitive verdict.

Then layer the judgment the script refuses to automate:

  • Pressure: container overlay genuinely full (rare - on shared-VM

runtimes overlay df reports the whole VM disk) means container caches (~/.cache, package stores) are the target, not the workspace.

  • Stray files: the script walks dirs only; shell-typo artifacts like

"&1" are yours to spot.

  • Promotions: KEEP entries flagged MODIFIED TRACKED FILES move to

tier 2 only when you can name every dirty file as a generated artifact (lockfiles, test output) and say so in the plan.

  • Demotions: tier 1/2 entries that are functionally live - symlink

targets, open-PR checkouts - move to keep.

  • Keepers: offer cache-prune (node_modules, dist, coverage) as the

low-risk alternative; for LOCAL-ONLY work, say exactly what would be lost and suggest pushing it.

Done when every candidate sits in a tier you can defend. Present the plan and stop - pass two starts only from explicit approval, tier by tier.

Pass two: execute approved tiers

  • Linked worktrees: git -C <parent> worktree remove <path> is the

only removal path. Its refusal on a dirty tree is the safety net, so no --force - and no rm -rf, which bypasses the net and leaves stale metadata behind.

  • Tier 2 trees: first delete the named generated files (restore

tracked ones with git checkout --), so the tree is genuinely clean and the safety net stays armed.

  • Stale metadata: git -C <parent> worktree prune.
  • Standalone repos (pushed, clean) and plain dirs: rm -rf.

Safe by construction: git worktree remove deletes the checkout only; branch refs live in the parent repo's .git and survive. Committed work is never lost - only uncommitted files can be. The metadata edit inside the parent's .git is normal bookkeeping, not touching the mount.

Done when df shows the reclaim and a triage rerun reports empty tiers.

Security

  • Security scanPassed, 96 of 100Pattern checks on the skill's files.
  • Model reviewNot runA model review is scheduled for the next rescan.

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

Repository stars
13
Repository forks
4
7-day trend score
13

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/thevibeworks/deva/deva-clean/badge)](https://verified-skill.com/skills/thevibeworks/deva/deva-clean)

Something wrong with this skill or its page? Tell us.