Your AI Coding Agents Are Filling Up Your Disk. Here’s How to Clean Up Safely

Description and use

AI coding agents generate files that consume disk space. Using the agent‑janitor CLI, users can scan, classify, and safely delete these files, archiving them first and restoring them if needed.

Problem

AI coding agents leave behind session transcripts, debug logs, caches, and old worktrees that accumulate and consume disk space, making it hard to identify what is safe to delete.

Outcome

Disk space is reclaimed without losing important session data, and users can restore archived items when needed.

Workflow

• Run a read‑only scan with npx agent-janitor scan to list found items, sizes, timestamps, and classifications.
• Review the scan output, noting any credential patterns flagged in transcript content.
• Execute cleanup with npx agent-janitor clean, which archives eligible items and removes them after a 30‑day retention gate.
• Restore archived data if needed using agent-janitor restore --list, agent-janitor restore latest, or by specifying a session ID or project name.

Evidence

agent-janitor scans agent data across tools, shows what it finds, and archives eligible files before removing them.

Source

By default, it applies a 30‑day retention gate, so recent or active data is skipped.

Source

It can also scan transcript content for known credential patterns. That’s an exposure warning—not automatic secret removal or redaction.

Source