Markdown
Install · 5 minutes

Install AutoVault.
One command. No daemon.

Install the CLI, add a skill once, then use it from Claude Code, Codex, or Cursor — with no forks to keep in sync.

v0.4.0 · pre-1.0 · MIT
$npm install -g @autoworks-ai/autovault
Installer endpoint: autovault.shview source
requiresmacOS13+Linuxx64 / arm64WindowsWSL2Node24+Disk< 40 MB
~ — autovault — bash

Step 1 · Install

All three channels install the same release, so pick whichever you already use. The shell installer does the most: it creates ~/.autovault, leaves the folder owned by you, and seeds the bundled skills — set AUTOVAULT_NO_BOOTSTRAP=1 if you would rather start empty. Nothing runs in the background; your agent starts AutoVault only when it needs it.

bash
# Node 24+: install the published npm package
$ npm install -g @autoworks-ai/autovault
# Or run the installer script end-to-end
$ curl -fsSL https://autovault.sh | sh
# macOS: also available through the tap
$ brew install autoworks-ai/tap/autovault
$ autovault skill list
Bundled skills. Installer and setup flows seed first-party bundled skills through the same validation path used by remote installs and proposals, then refresh discovered host profiles.

Rather have your agent do it?

If you want Claude Code to configure its own AutoVault bootstrap skill, give it this prompt. The hosted skill is a raw SKILL.md; the agent should fetch it, show you the behavior, install it locally only after approval, then run it.

textClaude Code prompt
Fetch https://autovault.dev/skill.md, show me what it will do, install it into ~/.claude/skills/autovault-bootstrap/SKILL.md if approved, then run /autovault-bootstrap.
Opt-in by design. The bootstrap skill stages the installer for inspection, asks before shell execution, then runs autovault doctor and autovault sync-profiles --discover.

Finish setup

autovault setup finds the agents already on your machine — it looks in ~/.claude/skills, ~/.codex/skills and ~/.cursor/skills — then walks you through each skill it found and asks what you want done with it. Safe to run again whenever you install a new agent.

bash
$ autovault setup --review
Installed via Claude Code or another agent's shell tool? The install ran without a TTY, so the wizard was silently skipped. Open a real terminal and run autovault setup to finish onboarding. If your existing ~/.claude/skills didn't import, pick the backup adoption mode (not the augment default). See Troubleshooting for the full recovery.

Check it worked

One command tells you whether the CLI, the vault folder, your signing key, and agent discovery are all in place.

autovault doctor
$autovault doctor
✓ binary signed · v0.4.0
✓ ~/.autovault initialized · bundled skills indexed
✓ local keypair available · ed25519
✓ detected agents · claude-code, codex
↳ next: autovault add <source-or-path>

Step 2 · Add your first skill

Point autovault add at a folder, a GitHub repo, an agentskills slug, or a direct SKILL.md URL. Wherever it came from, it goes through the same gate before it reaches your vault — the frontmatter is repaired, the contents are scanned, what the skill declares is checked against what it actually does, and the result is signed.

bash
$ autovault add ./skills/skill-author --sync-profiles --yes
gate run · skill-author
↳ scanning ./skills/skill-author
✓ yaml-repair · frontmatter clean
✓ denylist · no known bad patterns
✓ capability/behavior · declared matches observed
✓ dedup · no near match in vault
✓ sign · ed25519 provenance recorded

The vault is a folder

The final model is intentionally boring: a regular folder on disk. This is the current implementation layout: SQLite index, local signing key, source skills, source metadata, signed manifests, rendered variants, and profile links. Select a row to inspect how the folder is read.

How skills reach each agent

Every agent reads skills from its own folder. Syncing links the skills you have admitted into those folders, and never overwrites a file you put there yourself. Which skills go where comes from each skill's own metadata, or from named profiles in profiles.config.json. Remote clients read over MCP rather than expecting symlinks on the machine.

bash
$ autovault sync-profiles --discover
AgentReads fromHow
Claude Code~/.autovault/profiles/claude-code/skill-authorsymlink into ~/.claude/skills
Codex~/.autovault/profiles/codex/skill-authorsymlink into ~/.codex/skills
AutoJack~/.autovault/skills/skill-author/SKILL.mdnative read of canonical source

Step 3 · Run it from your agent

The same skill is now validated, scoped, and rendered for each target agent. The skill name stays stable, while tool names are transformed to match the caller.

claude code# in Claude Code
> use skill-author to draft a new SKILL.md
✓ tool resolved: Read, Edit, Write
# extracting...
"This 24-page report covers Q1 platform metrics, with three..."

Remove a skill cleanly

If a skill no longer belongs in the vault, remove it through AutoVault rather than deleting folders by hand. The command deletes the vaulted copy and its vault-local transforms, refreshes generated profiles, and prunes AutoVault-managed symlinks from discovered native agent roots.

bash
$ autovault remove skill-author
# automation-friendly output
$ autovault remove skill-author --json
Discovery is default. Use --no-discover only when you intentionally want to leave discovered native host roots untouched. Use --link agent=/path/to/skills for a custom profile root.

Where to next