snapguard
Official CLI package for keeping opencode/Cursor snapshot growth under control.
Install (local dev)
uv tool install --force /Users/ever/Documents/GitHub/snapguard
Install via Homebrew
brew tap ever-oli/homebrew-tap
brew install ever-oli/homebrew-tap/snapguard
Install via PyPI
uv tool install snapguard
# or
pipx install snapguard
Note: PyPI publishing is wired via GitHub Actions on v* tags. First-time setup requires creating the snapguard project on PyPI and adding a Trusted Publisher for repo ever-oli/snapguard, workflow .github/workflows/publish-pypi.yml, environment pypi.
Commands
snapguard --interactive
snapguard --status
snapguard --dry-run
snapguard --schedule hourly --cap-gb 5
# short alias
sg --interactive
What it monitors
~/.local/share/opencode/snapshot~/Library/Application Support/Cursor/User/workspaceStorage~/Library/Application Support/Cursor/snapshots~/Library/Application Support/Cursor/User/globalStorage
1 maintainer
Metadata
1 maintainer
Release files for snapguard 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| snapguard-0.1.1.tar.gz | 5.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| snapguard-0.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 12.1 kB
Release files / snapguard-0.1.1.tar.gz
| Download URL | snapguard-0.1.1.tar.gz |
|---|---|
| Size | 5.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
64913657cbb247d496aa7e0f194777b45b30c07fc67eb2e37047a638de768a7c
|
|
BLAKE2b-256 checksum How to use checksums |
e9357541558b42303acfcec104335d6ce50529183250dcb392bc12089d9d592c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 1, 2026.
Transparency logRelease files / snapguard-0.1.1-py3-none-any.whl
| Download URL | snapguard-0.1.1-py3-none-any.whl |
|---|---|
| Size | 6.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
25bc667da328178f104406110c332f1425f78f6c654449d48ad2e8d4f83e1444
|
|
BLAKE2b-256 checksum How to use checksums |
bd9fd32ba3cdbadf77e16f9cfcb3aac708dcddab41733990bedd9e99bfded8fa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 1, 2026.
Transparency log
