{"id":43576255,"url":"https://github.com/jojomi/rot","last_synced_at":"2026-02-03T23:15:43.823Z","repository":{"id":57532517,"uuid":"87620268","full_name":"jojomi/rot","owner":"jojomi","description":"\"I will delete that file later, promised\" – because humans are so bad at keeping promises!","archived":false,"fork":false,"pushed_at":"2024-11-08T22:01:00.000Z","size":479,"stargazers_count":7,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-11-08T23:17:20.583Z","etag":null,"topics":["automatic","cleanup","cli","delayed","delete","maintenance","remove","server","softdelete"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jojomi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-04-08T08:39:53.000Z","updated_at":"2024-11-08T22:01:04.000Z","dependencies_parsed_at":"2022-09-26T18:22:08.216Z","dependency_job_id":null,"html_url":"https://github.com/jojomi/rot","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/jojomi/rot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jojomi%2Frot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jojomi%2Frot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jojomi%2Frot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jojomi%2Frot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jojomi","download_url":"https://codeload.github.com/jojomi/rot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jojomi%2Frot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29060791,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-03T23:14:54.203Z","status":"ssl_error","status_checked_at":"2026-02-03T23:14:50.873Z","response_time":96,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automatic","cleanup","cli","delayed","delete","maintenance","remove","server","softdelete"],"created_at":"2026-02-03T23:15:41.300Z","updated_at":"2026-02-03T23:15:43.815Z","avatar_url":"https://github.com/jojomi.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# rot\n\n[![Go Report Card](https://goreportcard.com/badge/github.com/jojomi/rot)](https://goreportcard.com/report/github.com/jojomi/rot)\n\nYou have that file on your hard disk (oh SSD these days, pardon me) that you might need in a couple hours or a few days. You know you probably won't need it again, but what if? What if you have to install your Linux server yet again tomorrow because you already screwed it up? Would you want to redownload that huge ISO file? Rather not, but you will forget about that file sitting in your downloads folder occupying all that precious expansive storage space. If you are lucky, you will find it hogging your resources unnecessarily when cleaning up in a year thinking why the hell you never got around to delete that hopelessly outdated and outrageously big file. You are human! And you are not alone. I feel with you. Let's have someone (something?) else take care.\n\n`rot` is a tool that will take care of removing files and folders you know you will not need anymore after a certain time. You can specify either a number of hours or days or a rot date after which `rot` can safely remove it from your disk.\n\n\n# Usage\n\n```\nrot empowers you to stage files and folders for rotting (later deletion).\n\nUsage:\n  rot [command]\n\nAvailable Commands:\n  add         Add files or folders for rotting\n  clean       Clean files and folders that are rotten\n  help        Help about any command\n  list        List the files and folders current rotting\n  stop        Stops a file or folder from rotting\n```\n\nFor all usage details call `rot --help` or add `--help` to any of the subcommands listed.\n\nYou could use `rot clean --dry-run` for monitoring if there are files that should be deleted. If you are brave enough to automate it more, run the command `rot clean` periodically. If you want to monitor for files or folders that were changed since being staged for deletion, use this: `rot list --changed`.\n\n\n# Downloads\n\nCurrently this project is in **alpha** status. This means even though there is unit tests for the basic features it still needs to be tested with real life use cases. Ready-built binaries can be downloaded on the [releases page](https://github.com/jojomi/rot/releases).\n\nYou can build and run this code like any other [Go](https://golang.org) code:\n\n    go install github.com/jojomi/rot@latest\n\n\n# Development\n\nIf you encounter problems please open an issue.\n\n## Run Tests\n\n    go test github.com/jojomi/rot/cmd\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjojomi%2Frot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjojomi%2Frot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjojomi%2Frot/lists"}