A guide for connecting to HashiCorp Vault, a service that stores and provides secrets such as passwords and API keys. It gives the local address, access token, health check, and commands for managing secrets.

Checking whether Vault is healthy, then writing, reading, listing, or deleting stored secrets with command-line requests.

It removes the need to work out how this Vault instance is reached or how its API expects authentication and secret paths.

vault-user — Skill for Claude Code and Codex by mvschwarz/openrig

About the project

OpenRig is a software harness that coordinates Claude Code and Codex coding agents as one system, with agent teams defined in YAML and launched together. It is for organizing persistent teams of coding agents that can delegate work to specialists and return results or decisions. The catalogue lists 53 skills and one plugin as add-ons for OpenRig.

mvschwarz/openrig · 8,668 stars · on GitHub · openrig.dev

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add mvschwarz/openrig --skill vault-user

Clone the repo

git clone --depth 1 https://github.com/mvschwarz/openrig

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/mvschwarz/openrig/vault-user/github.svg)](https://agentmods.dev/skills/mvschwarz/openrig/vault-user)

Your own site

<a href="https://agentmods.dev/skills/mvschwarz/openrig/vault-user"><img src="https://agentmods.dev/badge/skills/mvschwarz/openrig/vault-user/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/mvschwarz/openrig/vault-user"><img src="https://agentmods.dev/badge/skills/mvschwarz/openrig/vault-user.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 29 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 529 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe. Third-party audits

NVIDIA SkillSpector warn 7 Sept 2026

SkillSpector: 1 finding, up to medium

These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →

medium Data Exfiltration · line 26
Data is being sent to an external URL. This could be legitimate telemetry or data exfiltration. Manual review is recommended.

Fix: Verify the destination URL is trusted and necessary. Remove or replace with documented APIs. Ensure no secrets, tokens, or PII are transmitted.

How audits are shown

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00029	$0.00529
Opus 5.5	$0.00012	$0.00212
Sonnet 5.5	$0.00006	$0.00106
Haiku 4.5	$0.00003	$0.00053

Measured 1mo ago against content hash 3248fef5f0a2, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

vault-user scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

Always set the token before making API calls. For curl, use `-H "X-Vault-Token: openrig-dev-token"`.

packages/daemon/specs/agents/apps/vault-specialist/skills/vault-user/SKILL.md · 70 lines

What it actually says

Vault User

You have access to a HashiCorp Vault instance managed by this rig's environment.

Connection

Address: http://127.0.0.1:8200
Token: openrig-dev-token
Auth header: X-Vault-Token: openrig-dev-token

Always set the token before making API calls. For curl, use -H "X-Vault-Token: openrig-dev-token".

Health Check

curl -s http://127.0.0.1:8200/v1/sys/health | jq .

A healthy response has "initialized": true and "sealed": false.

Secret Operations

Write a secret

curl -s -X POST http://127.0.0.1:8200/v1/secret/data/<path> \
  -H "X-Vault-Token: openrig-dev-token" \
  -d '{"data": {"key": "value"}}' | jq .

Read a secret

curl -s http://127.0.0.1:8200/v1/secret/data/<path> \
  -H "X-Vault-Token: openrig-dev-token" | jq .

The secret value is in .data.data.

List secrets

curl -s -X LIST http://127.0.0.1:8200/v1/secret/metadata/ \
  -H "X-Vault-Token: openrig-dev-token" | jq .

List a subdirectory by appending the path: .../secret/metadata/<prefix>/.

Delete a secret

curl -s -X DELETE http://127.0.0.1:8200/v1/secret/data/<path> \
  -H "X-Vault-Token: openrig-dev-token"

Explaining Secrets

When asked to explain the current secret structure, list all paths and summarize what each contains. Use the list endpoint recursively if needed.

Important Notes

This is Vault dev mode — all data is in-memory and lost on restart
The KV secrets engine is mounted at secret/ by default in dev mode
Use the rig env status command to verify Vault health through OpenRig before direct probing

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

1mo ago Changed · +5 lines · +29 tokens per session 3248fef5f0a2
2mo ago First seen · 65 lines · 0 tokens per session scan A c3c1e7bde567

Subscribe to this mod's changes

vault-user is a skill published in the GitHub repository mvschwarz/openrig (8,668 stars, last pushed yesterday), licensed Apache-2.0. It adds 29 tokens to every session and 529 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Claude Code Security agent-harness agent-orchestration agent-skills ai-coding cli

vault-user next to 6 skills from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
vault-usermvschwarz/openrig	Skill	8.7k	yesterday	Apache-2.0	A	29	Claude Code, Codex
metisWholiver/metis	Skill	438	7d ago	MIT	A	35	Claude Code, Codex
metis-browserWholiver/metis	Skill	438	7d ago	MIT	A	82	Claude Code, Codex
dynamic-resourcesWholiver/metis	Skill	438	7d ago	MIT	A	11	Claude Code, Codex
interviewHmbown/CodeWhale	Skill	41k	5d ago	MIT	A	40	Claude Code, Codex
verifyHmbown/CodeWhale	Skill	41k	5d ago	MIT	A	25	Claude Code, Codex
swarm-pr-reviewZaxbyHub/opencode-swarm	Skill	518	yesterday	MIT	A	91	Claude Code

vault-user