Skip to content
Vraelis homeDocs
Join Us

Agent add-ons

View as Markdown
Join UsGet Vraelis Prompto

Pin what an AI coding agent loads and launches with vraelis agents: MCP servers, Claude Code settings, skills and launched scripts.

Preview

vraelis agents is a preview. Its lockfile format may change.

vraelis agents records an AI coding agent's add-on configuration without launching anything:

  • MCP servers (.mcp.json, .cursor/mcp.json, .vscode/mcp.json);
  • Claude Code settings, with hooks and permissions as separate, diffable entries;
  • skills, agents and commands;
  • the local scripts those configs launch.
Lock, then verifyBash
vraelis agents lock   ./project         # writes ./project/addonlock.json
vraelis agents verify ./project
vraelis agents diff   old.json new.json
OptionWhat it does
--config CONFIGAn extra MCP config file (repeatable)
--pin-env NAMEAlso record this environment variable's value, in plain text (repeatable)
--pin-header NAMEAlso record this header's value, in plain text (repeatable)
--out OUTWrite the lockfile here instead of <folder>/addonlock.json (lock)
--strictRefuse to lock if any package is unpinned or floating (exit 3)
--lockfile LOCKFILECompare against this lockfile (verify)
--jsonMachine-readable output

Packages fetched at launch (npx, uvx, docker) are flagged when they are floating or unpinned; changes inside them are not seen. Secrets and limits

Last updated: October 24, 2026