~/diogo-nunes

Lab.

An experimental space where I ship open-source tools for the Laravel and AI engineering ecosystem.

Open Source

AI Shadow Vault

Shell-First CLI Homebrew

Keep AI Adapter Files Out of Git

AI Shadow Vault is a shell-first CLI that stores CLAUDE.md, AGENTS.md, and GEMINI.md in a machine-level vault and links them into each project only when needed. Your repo stays clean, your adapters stay reusable, and your setup stays deterministic across Git worktrees.

# Install via Homebrew

brew tap diogocnunes/tap

brew install ai-vault

# Link adapters to your project

ai-vault init

Get Started

Install in seconds. Link adapters to any project.

View on GitHub GitHub Stars

Why It Matters

  • ✔ Clean Repos: Adapters live outside the repository. No CLAUDE.md or AGENTS.md cluttering your commit history.
  • ✔ Worktree-Safe Identity: Stable project identity shared across all Git worktrees from the same vault.
  • ✔ Stack Snapshot: Auto-detects your tech stack from repository manifests and feeds it into adapter context.
  • ✔ Linked Knowledge Base: .ai/docs and .ai/plans symlinked from the vault, excluded from Git without touching .gitignore.

How It Works

Vault Architecture

Adapters, docs, and plans live in an external vault on your machine. Each project gets symlinks that point into that vault.

The ai-vault init command resolves your project root, derives a stable identity, generates adapters, and links .ai/docs and .ai/plans — all without committing a single file.

Three Commands

  • ai-vault install Setup wizard & global config
  • ai-vault init Link project to vault
  • ai-vault update Upgrade to latest version

Interested in implementing this workflow or discussing AI orchestration?

Let's book a technical talk