Skip to content

A lightning-fast desktop app for managing AI client configurations with visual editing, version control

License

Notifications You must be signed in to change notification settings

ppyyr/SystemPromptVault

Repository files navigation

System Prompt Vault

English | δΈ­ζ–‡

System Prompt Vault Logo

Version License Tauri Platform CI Build

A lightning-fast desktop app for managing AI client configurations with visual editing, version control, and instant switching between Claude, Codex, Gemini, and more.

Screenshots

Main Interface
Main Interface - Monaco Editor with Prompt Library

πŸ“Έ More Screenshots

Client Management

Client Manager

Prompt Management

Prompt Manager

Snapshot Management

Snapshot Manager

Dark Mode

Dark Mode


Why System Prompt Vault?

Managing multiple AI tool configurations (.claude/CLAUDE.md, .codex/AGENTS.md, .gemini/GEMINI.md) is painful:

  • βœ… Switching between AI clients requires manual file editing
  • βœ… No version control means no easy rollback
  • βœ… Reusing prompts across projects is tedious
  • βœ… Keeping track of changes is impossible

System Prompt Vault solves this with:

  • πŸš€ Instant Client Switching: Toggle between Claude, Codex, Gemini in seconds
  • 🎨 Professional Editor: Monaco Editor (VS Code core) with syntax highlighting, undo/redo
  • πŸ“Έ Snapshot Management: Auto/manual snapshots with FIFO cleanup and tray recovery
  • 🏷️ Smart Tagging: Filter prompts by tags, auto-detect client labels
  • πŸ”„ Live File Watching: Real-time detection of config file changes
  • 🌍 i18n + Themes: English/Chinese UI with light/dark mode
  • 🎯 Zero Frameworks: Vanilla JS + Rust + Tauri v2 for maximum performance

Core Features

πŸŽ›οΈ Client Management

  • Add custom AI clients with config paths (e.g., ~/.claude/CLAUDE.md)
  • Switch active client from dropdown menu
  • Auto-tag prompts by client type

πŸ“ Prompt Library

  • Create, edit, delete prompts with Monaco Editor
  • Apply prompts to active client config in one click
  • Import/export prompt collections for backup

πŸ” Smart Filtering

  • Multi-tag filtering with dropdown selector
  • Search by name or content
  • Recent tags auto-remembered

πŸ“Έ Version Control

  • Auto Snapshots: Created on app launch (max 10, FIFO cleanup)
  • Manual Snapshots: User-triggered with custom labels (max 20)
  • Tray Restore: Recover previous configs from system tray menu

🎨 Modern UX

  • Dark/Light theme with system preference detection
  • Responsive layout with Tailwind CSS
  • Accessible keyboard navigation (ARIA compliant)

Quick Start

Prerequisites

Installation

# Clone the repository
git clone https://github.com/ppyyr/SystemPromptVault.git
cd SystemPromptVault

# Install dependencies (Bun is 2-10x faster than npm)
bun install

# Run in development mode
bun run tauri:dev

Build for Production

# Standard build
bun run tauri:build

# macOS Universal (Intel + Apple Silicon)
bun run tauri:build:universal

Build artifacts:

  • macOS: src-tauri/target/release/bundle/dmg/
  • Windows: src-tauri/target/release/bundle/nsis/
  • Linux: src-tauri/target/release/bundle/deb/

Usage Guide

1. Add AI Clients

  1. Open Settings (βš™οΈ icon in top-right)
  2. Navigate to Client Management tab
  3. Click + Add Client
  4. Fill in:
    • ID: Unique identifier (e.g., claude)
    • Name: Display name (e.g., Claude Desktop)
    • Path: Config file path (e.g., ~/.claude/CLAUDE.md)
  5. Save and switch from main page dropdown

2. Manage Prompts

  1. In Settings β†’ Prompt Management
  2. Click + New Prompt
  3. Enter:
    • Name: Descriptive title
    • Content: Your prompt text
    • Tags: Add multiple tags (use dropdown or free input)
  4. Click Apply to append to active client config

3. Version Control

  • Auto Snapshot: Created every app launch
  • Manual Snapshot: Click snapshot button in main page
  • Restore: Right-click system tray β†’ Select snapshot

4. Import/Export

  • Export: Settings β†’ Export Prompts β†’ JSON file
  • Import: Settings β†’ Import Prompts β†’ Select JSON file

Tech Stack

Layer Technology
Frontend Vanilla JavaScript (ES6+), Vite 7, Tailwind CSS 3
Editor Monaco Editor (VS Code core)
Backend Rust + Tauri v2
Package Manager Bun (2-10x faster than npm)
Storage JSON file storage with atomic writes

Project Structure

SystemPromptVault/
β”œβ”€β”€ dist/                  # Frontend source (NOT build output)
β”‚   β”œβ”€β”€ index.html         # Main page (config editing)
β”‚   β”œβ”€β”€ settings.html      # Settings page (prompts/clients)
β”‚   β”œβ”€β”€ js/
β”‚   β”‚   β”œβ”€β”€ main.js        # Main page logic
β”‚   β”‚   β”œβ”€β”€ settings.js    # Settings page logic
β”‚   β”‚   β”œβ”€β”€ api.js         # Tauri API wrapper
β”‚   β”‚   β”œβ”€β”€ i18n.js        # Internationalization
β”‚   β”‚   └── theme.js       # Theme management
β”‚   └── locales/           # i18n resources
β”œβ”€β”€ build/                 # Vite build output
β”œβ”€β”€ src-tauri/             # Rust backend
β”‚   β”œβ”€β”€ src/
β”‚   β”‚   β”œβ”€β”€ commands/      # Tauri commands
β”‚   β”‚   β”œβ”€β”€ models/        # Data models
β”‚   β”‚   β”œβ”€β”€ storage/       # JSON repositories
β”‚   β”‚   └── tray.rs        # System tray
β”‚   └── tauri.conf.json
└── llmdoc/                # Developer documentation

Contributing

We welcome contributions! Please follow these steps:

  1. Fork this repository
  2. Create a feature branch (git checkout -b feature/YourFeature)
  3. Commit changes (git commit -m 'Add YourFeature')
  4. Push to branch (git push origin feature/YourFeature)
  5. Open a Pull Request

Development Guidelines

  • Follow existing code style (use cargo fmt for Rust)
  • Update documentation in llmdoc/ if adding features
  • Test on your platform before submitting
  • Keep commits atomic and descriptive

For detailed architecture and development guides, see llmdoc/.


FAQ

Q: Can I use this with other AI tools beyond Claude/Codex/Gemini? A: Yes! Add any custom client in Settings β†’ Client Management with a config file path.

Q: Where are my prompts and settings stored? A:

  • macOS: ~/Library/Application Support/SystemPromptVault/
  • Windows: C:\Users\<User>\AppData\Roaming\SystemPromptVault\
  • Linux: ~/.config/SystemPromptVault/

Q: How do I restore a previous config snapshot? A: Right-click the system tray icon β†’ Select a snapshot from the list.

Q: Does this app send data to external servers? A: No. All data is stored locally on your machine.

Q: Why use Bun instead of npm? A: Bun is 2-10x faster for installs and runs. npm still works if you prefer.


Documentation


License

MIT License


Credits

Built with:


Version: 0.1.16 Last Updated: 2025-11 Maintainer: Saul p@sora.im


About

A lightning-fast desktop app for managing AI client configurations with visual editing, version control

Resources

License

Stars

Watchers

Forks

Packages

No packages published