AgentVault

Never lose your AI coding history again.
Backup & restore full projects + chat history for
Codex CLI · Claude Code · OpenCode · Aider · Continue · Gemini CLI

Install · Features · After PC reset · Agents · Releases

---

Why AgentVault?

You live in AI coding agents. Your best work is in chats, not only git.

Reinstall Linux, switch laptops, or wipe a drive — and those histories disappear.

AgentVault is a desktop app that:

✅	Backs up full project source
✅	Backs up conversation history for every linked agent
✅	Uploads plain ZIP archives to your Google Drive
✅	One-click restore after a full PC reset — no vault password
✅	Auto path repair for Codex / Claude / etc. on the new machine

Keywords: AI coding agent backup · Codex CLI backup · Claude Code restore · OpenCode history · developer tools · Google Drive project backup

---

Install (Linux one-line)

curl -fsSL https://raw.githubusercontent.com/CodexNexor/agentvault/main/scripts/install.sh | bash

Then:

agentvault

The installer downloads the latest public release (.deb when possible, else tarball).

Debian / Ubuntu (.deb only)

curl -fL -o /tmp/agentvault.deb \
  https://github.com/CodexNexor/agentvault/releases/latest/download/agentvault_1.0.3_amd64.deb
sudo dpkg -i /tmp/agentvault.deb
agentvault

Tip: releases/latest/download/… always follows the newest release tag.

Windows

Download AgentVault-Portable-*.exe from Releases and run it.

macOS

.dmg when published on Releases.

From source

git clone https://github.com/CodexNexor/agentvault.git
cd agentvault
npm install
npm run dev
npm run package:linux   # .deb / AppImage / tar.gz

---

Features

Feature	Description
Complete Backup	Project files + all linked IDE histories → plain .avault ZIP → Google Drive
Cloud Projects	Fast Drive scan → one-click download, unzip, restore
Multi-IDE	Same repo used with Codex + Claude? Include both in one backup
Path repair	Chats work after path changes on a new PC
BYO Google OAuth	Your Desktop Client ID + secret — no shared 100-user cap
No encryption keys	Personal tool mode: plain ZIP, restore after wipe without passwords
Fast Drive scan	Parallel metadata fetch + short cache (v1.0.3+)

---

After PC reset / new laptop

1. Install your agents (Codex, Claude Code, …)
2. Install AgentVault (curl … | bash)
3. Settings → Google Desktop OAuth Client ID + secret → Connect
4. Cloud Projects → Restore all
5. Code → ~/Downloads/AgentVault-Restores/<project>
6. Histories → ~/.codex, ~/.claude, … automatically

No vault password. Connect Drive → restore.

---

Supported AI coding agents

• OpenAI Codex CLI
• Claude Code
• OpenCode
• Aider
• Continue
• Gemini CLI

Plugin architecture: implement AgentProvider to add more.

---

Google Drive layout

AgentVault/
  Backups/<ProjectName>/*.avault   # plain ZIP per project
  Metadata/<backupId>.json         # catalog for scan / restore

---

Privacy

• Archives live on your Google Drive only
• OAuth secrets stay on your PC (BYO Desktop app)
• Prefer scope drive.file (app-created files)
• Personal desktop tool — not a multi-tenant SaaS

---

Dev

npm run dev              # Electron + Vite
npm run package:linux    # deb + tar.gz + AppImage
npm run package:win      # Windows portable / NSIS

Latest release: v1.0.3

---

Links

• ⭐ Star on GitHub
• 📦 All downloads
• 🐛 Issues
• 📜 License: MIT

---

Built for the local-agent era · Codex · Claude Code · OpenCode · Aider