CLI Reference
CLI Configuration & Environment Variables
Reference for ~/.zyvop/config.json and all supported environment variables.
Configuration & Environment Variables
The ZyVOP CLI can be configured via interactive login, a JSON configuration file, or system environment variables.
Configuration File (~/.zyvop/config.json)
When you run zyvop login, the CLI creates a secure configuration file in your user home directory:
- Directory:
~/.zyvop(permissions:0700) - File:
~/.zyvop/config.json(permissions:0600)
{
"token": "zv_<48-hex-character-token>",
"endpoint": "https://zyvop.com/graphql"
}Supported Environment Variables
Environment variables always take precedence over values in ~/.zyvop/config.json.
Core CLI Variables
| Variable | Description | Default |
|---|---|---|
ZYVOP_TOKEN | Developer API token (zv_...) used for authentication | undefined |
ZYVOP_ENDPOINT | Custom backend GraphQL / API URL | https://zyvop.com/graphql |
ZYVOP_WEB_URL | Base URL used when printing public article links | https://zyvop.com |
Local Cross-Posting Variables (--local mode)
When running zyvop publish post.md --local, the CLI bypasses the ZyVOP cloud database and publishes directly using these local environment variables:
| Destination | Variable | Description |
|---|---|---|
| DEV.to | ZYVOP_DEVTO_API_KEY | DEV.to API key from dev.to/settings/extensions |
| Hashnode | ZYVOP_HASHNODE_API_KEY | Hashnode Personal Access Token |
| Medium | ZYVOP_MEDIUM_API_TOKEN | Medium Integration Token |
| Bluesky | ZYVOP_BLUESKY_IDENTIFIER | Your Bluesky handle (e.g. yourname.bsky.social) |
| Bluesky | ZYVOP_BLUESKY_APP_PASSWORD | App Password generated in Bluesky Settings |
| WordPress | ZYVOP_WORDPRESS_URL | Base URL of WordPress installation (https://blog.dev) |
| WordPress | ZYVOP_WORDPRESS_USERNAME | WordPress administrative or author username |
| WordPress | ZYVOP_WORDPRESS_APP_PASSWORD | WordPress Application Password |
Example .env File for CI/CD
# ZyVOP Authentication
ZYVOP_TOKEN="zv_<48-hex-character-token>"
# Local Mode Keys (Optional)
ZYVOP_DEVTO_API_KEY="dev_xxxx..."
ZYVOP_HASHNODE_API_KEY="hash_xxxx..."
ZYVOP_MEDIUM_API_TOKEN="med_xxxx..."
ZYVOP_BLUESKY_IDENTIFIER="alice.bsky.social"
ZYVOP_BLUESKY_APP_PASSWORD="xxxx-xxxx-xxxx-xxxx"