Setup Import
New machine in 60 seconds
npx promptreports-cli setup import bundle.jsonRestores a setup-export bundle on a fresh machine: env vars, skills, CLAUDE.md, MCP config, VS Code config — one command.
setup import takes a bundle produced by setup export and recreates the environment on a new machine. Decrypts env vars with the passphrase, writes .env.local (with backup if one already exists), restores .claude/skills/, CLAUDE.md, LESSONS.md, .mcp.json, and lists VS Code extensions for manual install. Use --diff first to preview every file that would change. Onboarding a new teammate becomes a single command instead of a half-day of copy-paste.
On this page
Prerequisites
- A bundle file produced by setup export
- The encryption passphrase if env vars are included
Flags & Options
| Flag | Description | Default |
|---|---|---|
| --decrypt <passphrase> | Decrypt env vars (required if bundle includes encrypted env) | — |
| --diff | Show what would be imported without writing anything | — |
| --dry-run | Preview without writing files | — |
Examples
Preview before import
npx promptreports-cli setup import bundle.json --diff --decrypt mySecret123See what would change before you commit.
Import on new machine
npx promptreports-cli setup import bundle.json --decrypt mySecret123Full restore in one command.
Import without env
npx promptreports-cli setup import bundle.jsonSkip env import — bundle without encrypted secrets.
Output
Shows source machine metadata, per-artifact progress, and any files backed up.
Source: MacBook-Pro (darwin arm64) — 2026-04-18T10:30:00Z
✓ Wrote 24 env vars to .env.local (existing backed up to .env.local.backup)
✓ Wrote .claude/skills/ (8 skills)
✓ Wrote CLAUDE.md (1,847 words)
✓ Wrote .mcp.json
✓ VS Code: install 12 extensions manually (list saved to .vscode/extensions-to-install.txt)
Import complete.What it reads and writes
Reads
- promptreports-setup.json (or bundle path argument)
Writes
- .env.local
- .env.local.backup (if .env.local already exists)
- .claude/skills/
- CLAUDE.md
- .claude/LESSONS.md
- .claude/settings.local.json
- .mcp.json
- .vscode/extensions-to-install.txt
Free vs Pro usage
Free tier
- One-command onboarding for a new teammate
- Restore your env after wiping a machine
- Try a teammate's shared skills + CLAUDE.md without rebuilding from scratch
Pro tier
Upgrade- Pull the latest team-wide setup template automatically
- Audit log: track who imported which template version
- Drift alerts when local config diverges from the canonical bundle
Pro tips
- Always run --diff first — it'll show you which files would be overwritten
- .env.local is automatically backed up to .env.local.backup before overwrite
- VS Code extensions need a manual install pass — the list is saved for `code --install-extension`