Folio

A small macOS helper that tidies local application caches and storage.

Folio walks known app data folders (browsers, chat clients, editors) and can:

• preview what would be cleaned
• clear stale caches with confirmation
• run in the background as a user LaunchAgent
• optionally expose a tiny local page so another device on your network can trigger a tidy

It is a single static Go binary. No runtime install.

macOS is fully supported. Windows can run the same CLI (Folio.exe) with Windows app maps (Chrome, Edge, Firefox, and common chat/editors). Linux is not packaged.

Portable USB

./Folio kit                 # writes dist/kit
# copy dist/kit to a USB stick

On the stick:

• Windows: Folio.cmd
• Mac: Folio.command

That runs setup --quiet --portable and starts helper run. Settings stay in folio-data on the stick. No LaunchAgent is installed in portable mode.

Build

go test ./...
go build -trimpath -ldflags "-s -w" -o Folio ./cmd/folio

Cross-compile from another OS:

# scripts/build.cmd on Windows, or:
CGO_ENABLED=0 GOOS=darwin GOARCH=arm64 go build -o dist/Folio-darwin-arm64 ./cmd/folio

Pack catalogs are compiled into the binary (go run ./tools/cloak first).

Usage

./Folio setup
./Folio status
./Folio doctor
./Folio tidy                 # preview
./Folio lock --preview
./Folio lock --confirm       # apply
./Folio helper install       # LaunchAgent
./Folio absorb ~/Downloads/old.zip --confirm
./Folio companion            # write the local companion page
./Folio serve                # http://127.0.0.1:8741

Destructive actions require --confirm. Paths outside your home directory are ignored.

Optional extras: sim dry-runs a situation, scan lists app folders that are not in a pack, pin stores a daily code and a guest code, unlock chooses which profile to open. With discover: true (default), Folio also inventories folders under ~/Library and applies cache maps to apps it has never seen before. Deletes follow NIST SP 800-88: on APFS, unlink plus local snapshot drop (overwrite is not a purge on copy-on-write). On other volumes, a DoD 5220.22-M three-pass overwrite then unlink. A receipt records which method ran.

Settings live in ~/Library/Application Support/Folio.

Layout

Path	Role
cmd/folio	CLI
internal/core	plans and rules
internal/engine	apply + helper loop
internal/platform	macOS / stub host
packs/macos	per-app cache maps
tools/cloak	embed pack files

License

MIT