Export & Backup

Your data belongs to you. Claspt stores everything as plain .md files in a regular directory — no proprietary database, no lock-in. You can export everything, anytime, in standard formats that work with other tools.

Complete Export (.zip)

Export your entire vault as a single .zip archive.

Go to Settings > Export.
Choose Complete Export.
Optionally set a password to encrypt the archive (see below).
Click Export and choose where to save.

The resulting .zip preserves your full folder structure. Each page is a standard .md file with secrets decrypted inline — you get the actual plaintext values, not ciphertext.

Export.zip
  general/
    2024-03-15-093012-api-credentials.md
    2024-03-18-140530-project-notes.md
  credentials/
    2024-03-20-110045-aws-keys.md

Password-Protected Export

When you set a password during export, Claspt encrypts the entire .zip with AES-256 encryption. The recipient needs the password to extract the archive. This is independent of your vault master password — you choose any password you like.

Secrets Only Export

Export just your secret values — without the surrounding notes — in a format compatible with other password managers.

Go to Settings > Export.
Choose Secrets Only.
Select your preferred format: CSV or JSON.

CSV Format

Produces a flat file with one row per secret:

Column	Example
Page	AWS Keys
Folder	credentials
Label	Access Key ID
Value	AKIA…

This format is compatible with 1Password, Bitwarden, and most password managers that support CSV import.

JSON Format

Produces a structured file with grouped fields per page:

{
  "pages": [
    {
      "title": "AWS Keys",
      "folder": "credentials",
      "secrets": [
        { "label": "Access Key ID", "value": "AKIA..." },
        { "label": "Secret Key", "value": "wJalr..." }
      ]
    }
  ]
}

This format preserves the grouping of secrets that belong to the same page, making it useful for structured imports into other tools.

Manual Backup

Because your vault is just a directory of .md files, you can back it up with any tool you already use:

Time Machine (macOS) automatically includes your vault directory.
File copy — drag the vault folder to an external drive.
Rsync or any backup utility works out of the box.

The vault directory lives at the path you chose during setup (default: ~/Claspt/). The .securenotes/ subfolder contains your encrypted master key and search index — include it in backups to avoid re-indexing.

Git-Based Backup

Claspt auto-initializes a Git repository in your vault and commits changes automatically. This gives you:

Full version history for every page.
Point-in-time recovery — restore any previous version from the Git log.
Remote backup — push to a private Git remote (GitHub, GitLab, etc.) for off-site backup.