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.