getreadystack/openbao-migration-lint repository overview

⁠OpenBao Migration Lint — HashiCorp Vault

OpenBao migration check for HashiCorp Vault scripts, Terraform, Helm values and server HCL: 14 rules, each with the OpenBao fix

⁠Run

docker run --rm -v "$PWD":/work getreadystack/openbao-migration-lint /work/file

The same 14 rules as the VS Code extension, in a container. Mount a folder on /work.

⁠Free

• Every finding in the open file, with the Vault line that breaks and the OpenBao fix, free and offline: 14 rules covering BSL Vault images (1.15.0 or later), HashiCorp Helm charts, HashiCorp package repos, storage backends, the 6 auto-unseal seals that became plugins in 2.7.0, auth methods, secrets engines, database plugins, VAULT_* variables, the vault binary, hvs. token checks, disable_mlock and Enterprise licence settings.
• --rules lists every rule

⁠With a licence ($29 once)

• Scan the whole workspace in one pass and export one migration report for the change ticket (every file, line, rule and fix in one Markdown report), $29 once, one licence key per person or team seat.

docker run --rm -e READYSTACK_LICENSE=<key> -v "$PWD":/work getreadystack/openbao-migration-lint --dir /work --ci

DOJ's Fitzpatrick Matrix rates a 15-year litigator at $851/hour for billing year 2026, which is one hour of counsel reading the BSL Additional Use Grant.

⁠Use from an AI agent (MCP)

Claude Code · Cursor · Windsurf · any MCP client - add to your MCP config:

{ "mcpServers": { "openbao-migration-lint": { "command": "npx", "args": ["-y", "@readystack/openbao-migration-lint", "--mcp"] } } }

Tools: check_text and check_file (free) · check_dir (licence). The agent gets every finding with the line number.

⁠Use in CI

- name: OpenBao Migration Lint — HashiCorp Vault
  run: npx -y @readystack/openbao-migration-lint --dir . --ci

(container: docker run --rm -v "$PWD:/work" getreadystack/openbao-migration-lint --dir /work --ci)

The folder sweep, reports and CI mode need one licence — one payment, no subscription. Set READYSTACK_LICENSE=<key> or run --license <key> once.

Get a licence⁠