varlock
AI-safe .env files: Schemas for agents, Secrets for humans.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/dmno-dev/varlock with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/dmno-dev/varlock'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/dmno-dev--varlock)HTML
<a href="/listings/dmno-dev--varlock"><img src="/api/listings/dmno-dev--varlock/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
These steps run a script from the network that findsafeskills does not scan.
You can get started with varlock by installing the CLI:
# Run the installation wizard, which will install as a dependency in a JavaScript project npx varlock init # Or install as standalone binary brew install dmno-dev/tap/varlock # via homebrew curl -sSfL https://varlock.dev/install.sh | sh -s # via cURL # Or use the official Docker image docker pull ghcr.io/dmno-dev/varlock:latest
See the full [installation docs](https://varlock.dev/getting-started/installation/) or the [Docker guide](https://varlock.dev/integrations/docker/) for more information.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 172 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- <p align="center">
- <a href="https://varlock.dev" target="_blank" rel="noopener noreferrer">
- <img src="/packages/varlock-website/src/assets/logos/wordmark.png" alt="Varlock banner">
- </a>
- </p>
- <br/>
- <p align="center">
- <a href="https://npmx.dev/package/varlock"><img src="https://img.shields.io/npm/v/varlock.svg" alt="npm package"></a>
- <a href="/LICENSE.md"><img src="https://img.shields.io/npm/l/varlock.svg" alt="license"></a>
- <a href="https://nodejs.org/en/about/previous-releases"><img src="https://img.shields.io/node/v/varlock.svg" alt="node compatibility"></a>
- <a href="https://github.com/dmno-dev/varlock/actions/workflows/test.yaml"><img src="https://img.shields.io/github/actions/workflow/status/dmno-dev/varlock/test.yaml?style=flat&logo=github&label=CI" alt="build status"></a>
- <a href="https://chat.dmno.dev"><img src="https://img.shields.io/badge/chat-discord-5865F2?style=flat&logo=discord" alt="discord chat"></a>
- <a href="https://depot.dev"><img src="https://img.shields.io/badge/CI%20powered%20by-Depot-46A75A?style=flat" alt="CI powered by Depot"></a>
- </p>
- <br/>
- ## Varlock
- > AI-safe .env files: Schemas for agents, Secrets for humans.
- - 🤖 AI-safe config — agents read your schema, never your secrets
- - 🔍 proactive leak scanning via `varlock scan` + git hooks
- - 🔏 runtime protection — log redaction and leak prevention
- - 🛡️ validation, coercion, type safety w/ IntelliSense
- - 🌐 flexible multi-environment management — auto .env.* loading and explicit import
- - 🔌 [plugins](https://varlock.dev/plugins/overview/) to pull data from various backends (1Password, Infisical, AWS, Azure, GCP, HCP Vault, more!)
- Unlike .env.example, **your .env.schema is a single source of truth**, built for collaboration, that will never be out of sync.
- ```bash
- # @defaultSensitive=false @defaultRequired=infer @currentEnv=$APP_ENV
- # ---
- # our environment flag, will control automatic loading of `.env.xxx` files
- # @type=enum(development, preview, production, test)
- APP_ENV=development # default value, can override
- # @type=port
- API_PORT=8080 # non-sensitive values can be set directly
- # API url including _expansion_ referencing another env var
- # @type=url
- API_URL=http://localhost:${API_PORT}
- # sensitive api key, with extra validation
- # @required @sensitive @type=string(startsWith=sk-)
- OPENAI_API_KEY=
- ```
- **Flexible plugin system**: adds new decorators, functions, types - enables secure declarative secret loading.
- ```bash
- # @plugin(@varlock/1password-plugin)
- # @initOp(token=$OP_TOKEN, allowAppAuth=forEnv(dev), account=acmeco)
- # ---
- # @type=opServiceAccountToken @sensitive
- OP_TOKEN=
- # Fetch secrets using 1Password secret references
- DB_PASS=op(op://my-vault/database-password/password)
- API_KEY=op(op://api-vault/stripe/api-key)
- ```
- ## Installation
- You can get started with varlock by installing the CLI:
- ```bash
- # Run the installation wizard, which will install as a dependency in a JavaScript project
- npx varlock init
- # Or install as standalone binary
- brew install dmno-dev/tap/varlock # via homebrew
- curl -sSfL https://varlock.dev/install.sh | sh -s # via cURL
- # Or use the official Docker image
- docker pull ghcr.io/dmno-dev/varlock:latest
- ```
- See the full [installation docs](https://varlock.dev/getting-started/installation/) or the [Docker guide](https://varlock.dev/integrations/docker/) for more information.
- ## Workflow
- Validate your `.env.schema` and pretty print your environment variables with:
- ```bash
- varlock load
- ```
- If you need to pass resolved env vars into another process, you can run:
- ```bash
- varlock run -- python script.py
- ```
- In many cases you can use our [drop-in integrations](https://varlock.dev/integrations/javascript/) for seamless experience - with additional security guardrails, like log redaction and leak prevention.
- ## AI-Safe Config
- Your `.env.schema` gives AI agents full context on your config — variable names, types, validation rules, descriptions — without ever exposing secret values. Combined with `varlock scan` to catch leaked secrets in AI-generated code, varlock is purpose-built for the AI era. Learn more in the [AI-safe config guide](https://varlock.dev/guides/ai-tools/).
- ## @env-spec
- Varlock is built on top of @env-spec, a new DSL for attaching a schema and additional functionality to .env files using JSDoc style comments. The @env-spec package contains a parser and info about the spec itself.
- - @env-spec [docs](https://varlock.dev/env-spec/overview/)
- - @env-spec [RFC](https://github.com/dmno-dev/varlock/discussions/17)
- ## Published Packages
- ### Core
- | Package | Published listing page |
- | --- | --- |
- | [varlock](packages/varlock) | [](https://npmx.dev/package/varlock) |
- | [@env-spec/parser](packages/env-spec-parser) | [](https://npmx.dev/package/@env-spec/parser) |
- | [@env-spec VSCode extension](packages/vscode-plugin) | [VSCode Marketplace](https://marketplace.visualstudio.com/items?itemName=varlock.env-spec-language), [Open VSX Registry](https://open-vsx.org/extension/varlock/env-spec-language) |
- | [varlock Docker image](Dockerfile) | [GitHub Container Registry](https://github.com/orgs/dmno-dev/packages/container/package/varlock) |
- ### Plugins
- | Package | Published listing page |
- | --- | --- |
- | [@varlock/1password-plugin](packages/plugins/1password) | [](https://npmx.dev/package/@varlock/1password-plugin) |
- | [@varlock/aws-secrets-plugin](packages/plugins/aws-secrets) | [](https://npmx.dev/package/@varlock/aws-secrets-plugin) |
- | [@varlock/azure-key-vault-plugin](packages/plugins/azure-key-vault) | [](https://npmx.dev/package/@varlock/azure-key-vault-plugin) |
- | [@varlock/bitwarden-plugin](packages/plugins/bitwarden) | [](https://npmx.dev/package/@varlock/bitwarden-plugin) |
- | [@varlock/dashlane-plugin](packages/plugins/dashlane) | [](https://npmx.dev/package/@varlock/dashlane-plugin) |
- | [@varlock/doppler-plugin](packages/plugins/doppler) | [](https://npmx.dev/package/@varlock/doppler-plugin) |
- | [@varlock/effect-plugin](packages/plugins/effect) | [](https://npmx.dev/package/@varlock/effect-plugin) |
- | [@varlock/google-secret-manager-plugin](packages/plugins/google-secret-manager) | [](https://npmx.dev/package/@varlock/google-secret-manager-plugin) |
- | [@varlock/hashicorp-vault-plugin](packages/plugins/hashicorp-vault) | [](https://npmx.dev/package/@varlock/hashicorp-vault-plugin) |
- | [@varlock/infisical-plugin](packages/plugins/infisical) | [](https://npmx.dev/package/@varlock/infisical-plugin) |
- | [@varlock/keepass-plugin](packages/plugins/keepass) | [](https://npmx.dev/package/@varlock/keepass-plugin) |
- | [@varlock/kubernetes-plugin](packages/plugins/kubernetes) | [](https://npmx.dev/package/@varlock/kubernetes-plugin) |
- | [@varlock/pass-plugin](packages/plugins/pass) | [](https://npmx.dev/package/@varlock/pass-plugin) |
- | [@varlock/passbolt-plugin](packages/plugins/passbolt) | [](https://npmx.dev/package/@varlock/passbolt-plugin) |
- | [@varlock/proton-pass-plugin](packages/plugins/proton-pass) | [](https://npmx.dev/package/@varlock/proton-pass-plugin) |
- ### Framework Integrations
- | Package | Published listing page |
- | --- | --- |
- | [@varlock/astro-integration](packages/integrations/astro) | [](https://npmx.dev/package/@varlock/astro-integration) |
- | [@varlock/cloudflare-integration](packages/integrations/cloudflare) | [](https://npmx.dev/package/@varlock/cloudflare-integration) |
- | [@varlock/expo-integration](packages/integrations/expo) | [](https://npmx.dev/package/@varlock/expo-integration) |
- | [@varlock/nextjs-integration](packages/integrations/nextjs) | [](https://npmx.dev/package/@varlock/nextjs-integration) |
- | [@varlock/nuxt-integration](packages/integrations/nuxt) | [](https://npmx.dev/package/@varlock/nuxt-integration) |
- | [@varlock/vite-integration](packages/integrations/vite) | [](https://npmx.dev/package/@varlock/vite-integration) |
- ## MCP Servers
- | MCP Server | Link | URL |
- | --- | --- | --- |
- | Varlock Docs (HTTP) | [Installation](https://varlock.dev/guides/mcp/docs-mcp/) | https://docs.mcp.varlock.dev/mcp |
- | Varlock Docs (SSE) | [Installation](https://varlock.dev/guides/mcp/docs-mcp/) | https://docs.mcp.varlock.dev/sse |
- ## Examples
- Examples of integrating varlock in various frameworks and situations can be found in the [Varlock examples repo](https://github.com/dmno-dev/varlock-examples)
- ## Development & Contribution
- See [CONTRIBUTING.md](CONTRIBUTING.md) for more information.
- ## Thanks to
- <a href="https://depot.dev">
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="https://depot.dev/assets/brand/1693758816/depot-logo-horizontal-on-dark.svg">
- <source media="(prefers-color-scheme: light)" srcset="https://depot.dev/assets/brand/1693758816/depot-logo-horizontal-on-light.svg">
- <img alt="Depot" src="https://depot.dev/assets/brand/1693758816/depot-logo-horizontal-on-light.svg" width="150">
- </picture>
- </a>
- CI infrastructure sponsored by [Depot](https://depot.dev), fast GitHub Actions runners.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.