README.md

metadata

title: Agent Vault
emoji: 🗄️
colorFrom: red
colorTo: yellow
sdk: docker
pinned: false
short_description: Agent Workspace Manager & Remote Execution Environment

🗄️ VAULT — Agent Workspace Manager & Execution Environment

File manager, version history, and remote code execution for AI agents.

Workspaces

workspace/
  code/      — scripts, modules, packages
  reports/   — generated docs, analysis outputs
  scratch/   — temp, experiments, throwaway
  shared/    — cross-agent shared artifacts

Execution Runtimes

Runtime	Command	Use
bash	bash -c	Shell scripts, system ops
python3	python3 -c	Data analysis, ML, scripting
node	node -e	JS/TS execution
npm	npm ...	Package management
pip	pip install	Python packages
git	git ...	Version control
go	go run	Go programs
cargo	cargo ...	Rust programs

MCP Config

{
  "mcpServers": {
    "vault": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://chris4k-agent-vault.hf.space/mcp/sse"]
    }
  }
}

MCP Tools

Tool	Description
vault_read	Read file content
vault_write	Write/create file (auto-snapshots)
vault_list	List directory contents
vault_exec	Execute code (bash/python/node/npm/pip/git)
vault_diff	Diff current file vs previous version
vault_versions	List version history
vault_search	Search by filename or content
vault_delete	Delete file or directory
vault_mkdir	Create directory
vault_move	Move/rename file
vault_stats	Workspace statistics

REST API

GET  /api/ls?path=code          List directory
GET  /api/read?path=code/x.py   Read file
POST /api/write                 Write file
POST /api/mkdir                 Create directory
DELETE /api/delete              Delete
POST /api/move                  Move/rename
POST /api/copy                  Copy
GET  /api/search?q=hello        Search
GET  /api/versions?path=...     List versions
GET  /api/version?path=...&vid= Get specific version
GET  /api/diff?path=...         Diff vs last version
POST /api/exec                  Execute code
GET  /api/exec/stream           SSE streaming execution
GET  /api/exec/log              Execution log
GET  /api/runtimes              Available runtimes
GET  /api/stats                 Workspace stats

Agent Usage

import requests
BASE = "https://chris4k-agent-vault.hf.space"

# Write a file
requests.post(f"{BASE}/api/write", json={
    "path": "code/analysis.py",
    "content": "import json\nprint(json.dumps({'result': 42}))",
    "agent": "researcher"
})

# Execute it
r = requests.post(f"{BASE}/api/exec", json={
    "runtime": "python3",
    "code": "import json\nprint(json.dumps({'result': 42}))",
    "cwd": "code"
})
print(r.json()["output"])

# Read back a file
content = requests.get(f"{BASE}/api/read?path=reports/output.json").json()["content"]

# Version history
versions = requests.get(f"{BASE}/api/versions?path=code/analysis.py").json()
print(versions["versions"])

# Run npm install
r = requests.post(f"{BASE}/api/exec", json={
    "runtime": "npm", "code": "install lodash", "cwd": "code"
})

Version System

Every vault_write auto-snapshots the previous content. Up to 20 versions per file. Diff view shows unified diff between any two versions.

Chris4K · ki-fusion-labs.de