palm cache

palm cache clean removes ~/.palm/cache, where palm keeps one checkout per source commit and one index per checkout.

palm cache clean [--yes]

Command	What it does
`palm cache clean`	Remove every checkout and index, after a confirmation.
`palm cache clean --yes`	Remove them without asking. Needed without a terminal.
`palm cache clean --dry-run`	Show what palm would remove.

$ palm cache clean --yes
- ~/.palm/cache (<size>)
sources stay declared; the next install fetches what it needs
$ palm install --offline
x source mattpocock/skills: source "mattpocock/skills" at 2c0db90 is not in the cache and --offline is set
  run the command again without --offline to fetch it
$ palm install
1 unchanged.

Subcommands

Command	Meaning
`palm cache clean`	Delete every checkout and index (sources stay declared).

Options

No options of its own. The global options apply.

Behavior

The cache holds <cache>/<source id>/sha-<commit>/, one checkout per commit, fetched once, and one index file per source, commit and layout. The folder has mode 0700, and the indexes hold redacted hashes, never secret values.

After palm cache clean, sources stay declared in palm.yaml and pinned in the lock. The next command that needs a commit fetches it again. A bare palm install --offline fails until then, because the locked commit is no longer cached.

palm never cleans the cache by itself. Delete it whenever you like; nothing else depends on it.

Reads and writes

Path	Writes
`$PALM_HOME/cache`	deleted

Exit codes

Code	When
`0`	The cache was removed, or was already empty.
`1`	No terminal and no `--yes`.
`2`	No subcommand, or an unknown one.
`130`	You answered no, or pressed Esc.