https://github.com/useformseal/fetch
CLI tool for fetching encrypted form submissions from your storage backend.
https://github.com/useformseal/fetch
cli cloudflare-kv formseal-ecosystem privacy redis security supabase
Last synced: 21 days ago
JSON representation
CLI tool for fetching encrypted form submissions from your storage backend.
- Host: GitHub
- URL: https://github.com/useformseal/fetch
- Owner: useFormseal
- License: mit
- Created: 2026-02-02T18:45:25.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-06-04T19:56:07.000Z (28 days ago)
- Last Synced: 2026-06-04T21:37:49.466Z (28 days ago)
- Topics: cli, cloudflare-kv, formseal-ecosystem, privacy, redis, security, supabase
- Language: Python
- Homepage:
- Size: 370 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: .github/SECURITY.md
Awesome Lists containing this project
README
Download encrypted form submissions from your storage backend.
formseal-fetch pulls ciphertexts stored by your backend down to your machine. Nothing is decrypted in transit or on the server — only the holder of the private key can read submissions.
formseal-fetch is not a hosted service or dashboard. It is a CLI fetch utility.
## Installation
**Via pipx (recommended)**
```bash
pipx install formseal-fetch
```
**Via pip**
```bash
pip install formseal-fetch
```
## Quick start
```bash
fsf connect provider:
fsf fetch
fsf status
```
## How it works
```
Browser (formseal-embed)
│
▼ (encrypted submissions)
Cloudflare KV / Supabase / any other server
│
▼ (fsf fetch)
ciphertexts.jsonl ──► Your PC
```
Your backend stores opaque ciphertext only. `fsf fetch` downloads it. Decryption happens separately, offline, with your private key.
## Commands
| Command | Description |
|---------|-------------|
| `fsf` | Show about / info |
| `fsf connect` | Connect to a storage provider |
| `fsf fetch` | Download ciphertexts |
| `fsf status` | Show connection info |
| `fsf disconnect` | Clear credentials |
| `fsf disconnect --wipe` | Clear everything including ciphertexts |
| `fsf --providers` | List available backends |
Run `fsf --help` for all options.
## Security
> Ciphertexts are encrypted at the source by formseal-embed. fsf only handles encrypted data — a backend compromise yields no plaintext.
Your API tokens never leave your machine. formseal-fetch:
- Stores credentials in your OS keychain (Windows Credential Manager / macOS Keychain / Linux Secret Service)
- Makes direct API calls to your storage backend only
- Sends no telemetry, has no analytics
- Skips already-downloaded ciphertexts automatically
## Documentation
Full documentation is in the [docs](./docs/README.md) directory.
## For developers
- [Provider guide](./docs/providers/README.md) — Add new storage backends
- [CONTRIBUTING.md](./CONTRIBUTING.md) — Full contributing guide
Please star the repo if you find formseal-fetch useful.
## License
MIT