🔏 Imprint v3

Stamp your developer environment on any machine.

Imprint is a premium CLI tool that snapshots your entire machine's developer setup — dotfiles, VS Code extensions, Neovim plugins, tmux config, global packages, shell settings — and restores it perfectly on a new machine in seconds. Now with named profiles, AES-256-GCM encryption, and multi-format export.

✨ What's New in v3

• 🧑‍💻 Named Profiles — work, home, laptop — switch with imp profile use
• 🔐 AES-256-GCM Encryption — encrypt dotfiles before pushing to GitHub
• 📤 Multi-Format Export — JSON, YAML, Markdown, or shell script
• 🔭 6 New Collectors — Neovim, Cursor IDE, tmux, SSH config, Cargo, uv
• 🩺 Doctor & Diagnostics — imp doctor validates your entire setup
• 📜 Snapshot History — browse past snapshots with imp history
• 🔄 Compare Snapshots — diff two snapshots with imp compare
• 👁️ Watch Mode — auto-snapshot on file changes
• 🎨 Nord Theme — premium UI with branded dashboard

🚀 Quick Start

1. Installation

pip install imprint-cli

# With encryption support
pip install imprint-cli[crypto]

# With watch mode
pip install imprint-cli[watch]

# Everything
pip install imprint-cli[full]

2. First-Run Setup

imp init

3. Capture Your World

imp snapshot

4. Move to a New Machine

imp restore https://github.com/your-username/my-imprint-config.git

🛠️ All Commands

🔍 What Gets Captured?

🔏 Security First

Imprint is designed to be secure by default. It never captures sensitive files. The .imprintignore system automatically blocks:

• 🔑 SSH Keys (.ssh/id_*, *.pem, *.key)
• 🎫 Tokens & Secrets (*.token, *secret*, *api_key*)
• 🌐 Environment files (.env, .env.*)
• ☁️ Cloud credentials (.aws/credentials, .gcloud/, .kube/)
• 📜 Shell history (.bash_history, .zsh_history)
• 🔒 GPG keys (.gnupg/)

All subprocess calls use list arguments (no shell=True) to prevent shell injection.

📦 Publishing

imprint-cli uses GitHub Actions with a PYPI_API_TOKEN secret for automated publishing:

# Tag a release on main (after merging PR)
git tag v3.0.0
git push origin main --tags
# GitHub Actions automatically builds and publishes to PyPI

Setup: Add your PyPI API token as a repository secret named PYPI_API_TOKEN in Settings → Secrets → Actions.

🤝 Contributing

See CONTRIBUTING.md for development setup, git workflow, and how to add new collectors.

📜 Code of Conduct

See CODE_OF_CONDUCT.md.

📄 License

MIT © Venkatesh-6921