Janitor

Delete stale notification and chain output files using TTL rules.

626|225|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/aaronjmars/aeon --skill janitor-aaronjmars
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Janitor
Source: https://github.com/aaronjmars/aeon/tree/main/skills/janitor
Command: npx skills add https://github.com/aaronjmars/aeon --skill janitor-aaronjmars

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents disk bloat by automatically removing old, no-longer-needed temporary and chain-output files that accumulate during normal autonomous skill operation.

Core Features & Use Cases

  • Clean up root-level notification leftovers: Removes stale .notify-* files older than 7 days (based on date suffix or mtime).
  • Remove temp notification gate artifacts: Deletes stale files inside .pending-notify-temp/ older than 7 days.
  • Purge expired chain artifacts: Removes .outputs/ chain step artifacts older than 14 days.
  • Safety guardrails: Never deletes .pending-notify/ or committed memory/pending-disclosures/, and avoids anything created within the last 2 days.
  • Operational logging and optional notification: Always appends a run summary to memory/logs/${today}.md, and only sends a notification when something was deleted.

Quick Start

Tell Aeon to run the Janitor task for this week to clean stale .notify-*, .pending-notify-temp/, and .outputs/ artifacts and then log the cleanup outcome.

Frequently Asked Questions about Janitor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically delete stale notification and chain output files in my repository?▼

To automatically delete stale notification and chain output files, you can use a cleanup routine that scans the local filesystem and deletes `.notify-*` and `.pending-notify-temp/` artifacts older than 7 days, plus `.outputs/` artifacts older than 14 days.

What is the best way to schedule weekly disk cleanup for autonomous agent artifacts?▼

The best way to schedule weekly disk cleanup for autonomous agent artifacts is to run a maintenance task that applies date-suffix or mtime TTL rules to purge outdated `.notify-*` and `.outputs/` files, preventing disk bloat.

How does file retention work for temporary notification artifacts?▼

File retention for temporary notification artifacts works by enforcing a 7-day TTL limit. It deterministically scans the filesystem and deletes outdated `.notify-*` files and `.pending-notify-temp/` artifacts based on their date suffix or modification time.

What safety guardrails prevent accidental deletion of active agent files?▼

Safety guardrails prevent accidental deletion by never touching `.pending-notify/` or committed `memory/pending-disclosures/` directories, and by avoiding the deletion of any files created within the last 2 days.

Does the cleanup process generate logs for deleted artifacts?▼

Yes, the cleanup process generates logs by appending a run summary to `memory/logs/${today}.md`. It also sends a conditional notification only when an artifact deletion has actually occurred during the maintenance run.

When should I not use an autonomous cleanup task for repository artifacts?▼

You should not use an autonomous cleanup task if you need to retain chain outputs or notification artifacts beyond 14 days, or if your workflow requires manual review of `.pending-notify-temp/` files before they are purged.