Ai Shadow Vault

AI Shadow Vault

Keep AI adapter files out of Git.

AI Shadow Vault is a shell-first tool for teams and solo developers who want `CLAUDE.md`, `AGENTS.md`, and `GEMINI.md` available inside each project without turning those files into repo noise.

It gives you:

• a clean ai-vault CLI
• a branded first-run installer
• adapters stored outside the repository
• stable project identity across Git worktrees
• linked .ai/docs and .ai/plans folders
• local Git exclusions managed without touching .gitignore

It does not try to be a memory engine, task system, skills runtime, or agent framework.

Preview


Why It Exists

Most teams want AI instructions close to the code, but not committed into every repository.

AI Shadow Vault solves that by storing adapter files in a machine-level vault and linking them into each project only when needed.

That means:

• your repo stays clean
• your adapters stay reusable
• your setup stays deterministic
• your worktrees share the same vault identity

Install

Homebrew is the primary install path.

brew tap diogocnunes/tap
brew install ai-vault
ai-vault

First Run

Run:

ai-vault

On first run, AI Shadow Vault opens a short interactive setup that lets you choose:

• vault base path
• default adapters
• RTK instructions toggle
• superpowers instructions toggle (when plugin detected)
• context-mode instructions toggle (when plugin detected)
• i-have-adhd instructions toggle (when plugin detected)

Global config is stored at:

$XDG_CONFIG_HOME/ai-shadow-vault/config.json

Fallback:

~/.config/ai-shadow-vault/config.json

Suggested default vault path:

~/.ai-shadow-vault-data

If synced folders are detected, they are offered as install choices too.

Main Commands

ai-vault install
ai-vault init
ai-vault update

`ai-vault install`

Runs the setup wizard or updates the existing machine-level conf