Vanish Connect Upgrade
Manage Vanish authentication, account status, storage limits, and Pro upgrade paths. Use this when publishing or uploading fails because of login, quota, retention, file type, slug, or tier constraints.
Account Commands
vanish login # GitHub OAuth, saves API key
vanish whoami # show current user and tier
vanish status # show storage usage, tier, and limits
vanish status --json
vanish logout # remove saved API key
vanish upgrade # open Pro checkout
vanish update # update the CLI to the latest version
vanish keys ls --json
vanish keys create --name agent-ci --json
vanish keys revoke <prefix> --json
vanish sites ls --json
vanish site info <id-or-slug> --json
vanish site rm <id-or-slug> --json
vanish site extend <id-or-slug> --days 90 --json
vanish site verify <id-or-slug> --json
If vanish is not installed, use npx vanish-cli <command>.
Workflow
- Run
vanish whoami for identity and tier questions.
- Run
vanish status --json when quota, size, retention, or rate limits matter.
- Explain the blocker and ask before running
vanish login; it opens OAuth and saves an API key.
- Explain the blocker and ask before running
vanish upgrade; it opens checkout.
- Run
vanish logout only after explicit user confirmation, because it removes the saved API key.
Configuration
Vanish reads config in this order:
- CLI flags.
- Environment variables:
VANISH_API_KEY, VANISH_API_URL.
- Config file:
~/.config/vanish/config.json.
- Defaults.
The config file can contain api_key and api_url. Environment variables override the file.
Tier Limits
| Tier |
Sites |
File uploads |
Retention |
Storage |
Rate limit |
| Anonymous |
300 MB, 100 files |
Images only, 300 MB max |
24h |
Ephemeral |
10/hour |
| Free |
500 files |
All except executables, 50 MB max |
48h |
50 MB total |
50/hour |
| Pro |
5,000 files, custom slugs |
All except executables, 1 GB max |
30 days, --days up to 365 |
10 GB total |
500/hour |
When To Route Here
--update fails or is needed: login is required.
--channel is requested: login is required.
--slug or --days is requested: Pro is required.
- Anonymous upload fails for non-image files: login is required.
- Storage quota or file size blocks sharing: check status, then suggest cleanup or upgrade.
- The API key is missing or invalid: login again or set
VANISH_API_KEY.
- A self-hosted or alternate API is needed: set
VANISH_API_URL.
Safety
Do not upload anything from this skill. Route back to vanish-publish-site or vanish-upload-files only after account or tier blockers are resolved.
1---2name: vanish-connect-upgrade3description: Use this skill for explicit Vanish account, authentication, status, quota, storage, tier, retention, API key, config, or upgrade questions, or after a publish/upload attempt reports an auth, quota, tier, `--days`, or `--slug` blocker. Use for read-only `whoami` and `status` checks, `VANISH_API_KEY`, `VANISH_API_URL`, config file behavior, anonymous/free/pro limits, invalid auth, and explaining when login or Pro is required. Do not use this skill first for normal upload or site publishing requests; route those to vanish-upload-files or vanish-publish-site.4---56# Vanish Connect Upgrade78Manage Vanish authentication, account status, storage limits, and Pro upgrade paths. Use this when publishing or uploading fails because of login, quota, retention, file type, slug, or tier constraints.910## Account Commands1112```bash13vanish login # GitHub OAuth, saves API key14vanish whoami # show current user and tier15vanish status # show storage usage, tier, and limits16vanish status --json17vanish logout # remove saved API key18vanish upgrade # open Pro checkout19vanish update # update the CLI to the latest version20vanish keys ls --json21vanish keys create --name agent-ci --json22vanish keys revoke <prefix> --json23vanish sites ls --json24vanish site info <id-or-slug> --json25vanish site rm <id-or-slug> --json26vanish site extend <id-or-slug> --days 90 --json27vanish site verify <id-or-slug> --json28```2930If `vanish` is not installed, use `npx vanish-cli <command>`.3132## Workflow33341. Run `vanish whoami` for identity and tier questions.352. Run `vanish status --json` when quota, size, retention, or rate limits matter.363. Explain the blocker and ask before running `vanish login`; it opens OAuth and saves an API key.374. Explain the blocker and ask before running `vanish upgrade`; it opens checkout.385. Run `vanish logout` only after explicit user confirmation, because it removes the saved API key.3940## Configuration4142Vanish reads config in this order:43441. CLI flags.452. Environment variables: `VANISH_API_KEY`, `VANISH_API_URL`.463. Config file: `~/.config/vanish/config.json`.474. Defaults.4849The config file can contain `api_key` and `api_url`. Environment variables override the file.5051## Tier Limits5253| Tier | Sites | File uploads | Retention | Storage | Rate limit |54|------|-------|--------------|-----------|---------|------------|55| Anonymous | 300 MB, 100 files | Images only, 300 MB max | 24h | Ephemeral | 10/hour |56| Free | 500 files | All except executables, 50 MB max | 48h | 50 MB total | 50/hour |57| Pro | 5,000 files, custom slugs | All except executables, 1 GB max | 30 days, `--days` up to 365 | 10 GB total | 500/hour |5859## When To Route Here6061- `--update` fails or is needed: login is required.62- `--channel` is requested: login is required.63- `--slug` or `--days` is requested: Pro is required.64- Anonymous upload fails for non-image files: login is required.65- Storage quota or file size blocks sharing: check status, then suggest cleanup or upgrade.66- The API key is missing or invalid: login again or set `VANISH_API_KEY`.67- A self-hosted or alternate API is needed: set `VANISH_API_URL`.6869## Safety7071Do not upload anything from this skill. Route back to `vanish-publish-site` or `vanish-upload-files` only after account or tier blockers are resolved.