- Home
- Skills
- Agents & Orchestration
- Vaults Hub – Agent Memory in Markdown
Works with the AI Agents you already use
Vaults Hub – Agent Memory in Markdown
Persistent project memory for your agent — read, write, search and restore Obsidian-style notes with git versioning.
Free
Vaults Hub – Agent Memory in Markdown
Example session with this skill installed
In my vault AcmeApp, find all notes about auth decisions, summarize them, then save the summary as decisions-auth.md with proper frontmatter and wiki-links.
- Read your context and instructions
- Compiled the vaults hub
Summary
Searched 12 notes in AcmeApp, found 3 auth decisions, saved consolidated summary to decisions-auth.md.
| Metric | Before | After |
|---|---|---|
| Auth notes scattered | 3 files | 1 source of truth |
| Lookup time | manual grep | search_notes in 0.3s |
| Versioning | none | git history + restore |
# what the agent ran
search_notes(query="auth decision", vault="AcmeApp", before=1, after=1)
read_note(vault="AcmeApp", path="auth-jwt.md") # save sha256
write_note(vault="AcmeApp", path="decisions-auth.md", content="---\ntitle: Auth Decisions\ntags: [acme/auth]\n---\n\nSee [[auth-jwt]] and [[auth-oauth]]\n", expected_sha256=None)
history(vault="AcmeApp", path="decisions-auth.md")
Next steps
- Ask your agent restore(vault="AcmeApp", path="decisions-auth.md", rev="<sha>") to roll back any bad edit
- Use [[wiki-links]] to connect new notes — backlinks update automatically
Connects securely to your tools. The creator never sees your data.
About this skill
Stop losing decisions, todos and context between sessions.
Vaults Hub gives any SKILL.md-compatible agent persistent memory as plain Markdown on disk — no Obsidian plugins, windows, ports, or API keys. Each project gets a vault under ~/.vaults, every change is auto-versioned with local git.
What you get:
- 14 tools:
list_vaults,read_note,write_note,append_note,move_note,delete_note,search_notes,list_tags,history,restore+ more - Safe concurrent edits: atomic writes,
fcntllocking,expected_sha256optimistic concurrency - Full-text search via ripgrep with Python fallback, backlinks +
[[wiki-links]], tag index - Fail-open versioning: disk write always wins, git failure only warns as
commit_error - Private by design: stdio MCP, closed-world (
openWorldHint: false), no push/pull/fetch
Perfect for coding agents that need to remember architecture, decisions, and todos across runs.
Run in 10s: npx -y vaults-hub
Note paths must end in .md. Search is capped at 20 hits per file. Git history features require VAULTS_HUB_GIT to be enabled. Vault names must be pre-resolved or created before mutation.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
1 use
Times used to date
Free forever
No account required to browse
Trust & safety
Security scan
Security scan passed 1 month ago
- Free with an Agensi account
Permissions
File Scopes
Local-only file access to Markdown vaults under VAULTS_ROOT (default ~/.vaults). Reads/writes *.md + frontmatter, maintains per-vault local git for history/restore. No network, no browser, no external services. Env vars only for root path and git/debug flags.