28 Unix tools. One binary. Zero dependencies.·the missing coreutils for the agent era·try vrk in your browser at vrk.sh/play·curl vrk.sh/install.sh | sh - ready in 5 seconds·

Environment Variables

vrk reads environment variables in only two of its 28 tools: vrk prompt and vrk kv. The other tools need no configuration, and vrk has no config file.

vrk prompt

vrk prompt is the only tool that needs an environment variable. Set one API key to start.

VariableRequiredWhat it doesDefault
ANTHROPIC_API_KEYRequired for Anthropic modelsAuthenticates requests to the Anthropic APInone
OPENAI_API_KEYRequired for OpenAI modelsAuthenticates requests to the OpenAI APInone
VRK_LLM_KEYOptionalGeneric Bearer token for OpenAI-compatible endpoints that don’t use the standard key namesnone
VRK_DEFAULT_MODELOptionalDefault model when --model is not specifiedclaude-sonnet-4-6 or gpt-4o-mini
VRK_LLM_URLOptionalBase URL for an OpenAI-compatible API endpointProvider default

At least one of ANTHROPIC_API_KEY or OPENAI_API_KEY is required. Provider selection is automatic: claude-* models use Anthropic, gpt-* models use OpenAI. If only one key is set, that provider is used regardless of model name.

When VRK_LLM_URL (or --endpoint) is set, there is no default model. Pass --model or set VRK_DEFAULT_MODEL, or prompt exits 2 with “–model is required when using –endpoint”.

vrk kv

vrk kv works without setup. The only environment variable sets where the database is stored.

VariableRequiredWhat it doesDefault
VRK_KV_PATHOptionalPath to the SQLite database file~/.vrk.db

Everything else

The other 26 tools (tok, chunk, grab, mask, validate, jwt, epoch, uuid, sse, coax, links, plain, jsonl, emit, assert, sip, throttle, digest, base, recase, slug, moniker, pct, urlinfo, pdf, sql) need no environment variables. They work without setup.

Flag precedence

When both a flag and an environment variable are set, the flag wins:

FlagOverrides
--modelVRK_DEFAULT_MODEL
--endpointVRK_LLM_URL

VRK_KV_PATH has no flag equivalent. Set it in your shell profile or per-pipeline with export.